Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Редактируемая таблица

Таблица с возможностью редактирования значений ячеек.

В экземпляре типа Редактируемая таблица можно:

  • конфигурировать столбцы таблицы на основе модели данных или с помощью функции;
  • использовать тему оформления для декорирования таблицы с возможностью переопределить декоратор;
  • добавлять, удалять и перемещать строки с помощью клавиш;
  • проверять корректность ввода в редакторе значений;
  • добавлять пользовательские редакторы значений с помощью типа Редактор ячейки таблицы;
  • использовать встроенные типы редакторов значений.

Тип является наследником типа Таблица (Table), предоставляемого расширением Alpha.HMI.Tables, поэтому имеет похожий принцип использования в проекте и такие же свойства, функции, события. Чтобы начать работу с таблицей, необходимо задать модель данных с помощью экземпляра типа Модель данных, предоставляемого расширением Alpha.HMI.Tables. Подробнее об этом – в документации на Alpha.HMI (содержит документацию для Alpha.HMI.Tables), кратко – ниже.

Пример использования в проекте

Заполнение таблицы на основе модели данных

  1. Поместите в рабочую область экземпляры типов Таблица: модель данных и Редактируемая таблица.
  2. Создайте модель данных. Сделать это можно либо вручную, либо заполнив модель данными от источника. Подробнее об этом – в документации на Alpha.HMI, раздел "Формирование таблиц".
  3. Сошлитесь на созданный экземпляр Таблица: модель данных из свойства Модель данных вашего экземпляра типа Редактируемая таблица.
  4. Вызовите функцию ConfigureByModel() для вашего экземпляра типа Редактируемая таблица.

Пусть нужно создать таблицу с двумя колонками. В одной можно будет указать должность сотрудника, в другой – фамилию. Значение в обеих колонках вводится вручную.

Для создания таблицы с двумя колонками и тремя строками можно использовать следующий код, написанный на языке Alpha.Om:

TableModel.AddColumn("title", "","","","string", false, true); /* функция добавляет 
в модель данных столбец для указания должности с идентификатором title, 
без заголовка, без описания, с типом данных string, 
с возможностью записи значения, с разрешением не содержать данных в ячейках */
TableModel.AddColumn("surname", "","","","string", false, true); /* такой же столбец,
но для ввода фамилии */
EditableTable.ConfigureByModel(); // таблица конфигурируется в соответствии с моделью данных
for (i: int4 = 0; i <= 2; i += 1)
 EditableTable.AddRow(); // таблица заполняется тремя строками

Полученная таблица будет выглядеть так:

Переопределение таблицы с изменением типа редактора ячейки

Столбцы таблицы, сформированной с помощью функции ConfigureByModel(), можно переопределить. Для этого вызовите функцию Configure() для вашего экземпляра типа Редактируемая таблица, указав в качестве входного значения JSON-строку, описывающую переопределенную модель таблицы.

Пусть в таблице, созданной ранее, нужно указать заголовки столбцов, а редактор ячейки одного из столбцов заменить на выпадающий список с возможными значениями.

Для этого можно использовать следующий код, написанный на языке JavaScript:

var config = { // создается объект
 'columns': [
  { 'id': "title", 'title': "Должность", 'values': [ "Оператор", "Диспетчер" ], 'editorType': "1" },
  /* для первого столбца указывается заголовок, тип редактора заменен на выпадающий список (1)
  с возможными значениями "Оператор" и "Диспетчер" */
  { 'id': "surname", 'title': "Фамилия" } // для второго столбца указан заголовок
 ]
} 
Configure(JSON.stringify(config)); /* таблица переопределяется в соответствии с JSON-строкой, 
полученной на основе описанного объекта */

Переопределенная таблица будет выглядеть так:

В режиме рантайма можно:

  • Добавить строку, нажав клавишу Insert.
  • Удалить строку, нажав сочетание клавиш Ctrl+Delete.