Alpha.Community

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

Свойства

Модель данных (TableModel)

Ссылка на экземпляр типа Таблица: модель данных, предоставляемый Alpha.HMI.Tables.

Таблица: модель данных формирует невизуальную модель, предназначенную для хранения данных в табличном виде.

Возможность добавления строк (CanAddRows)

Разрешает добавление новых строк в таблицу. Тип значения – уведомляющий bool.

Значение:

  • true – добавление новых строк разрешено;
  • false – добавление новых строк запрещено.

Чтобы добавить новую строку, используйте клавишу Insert.

Возможность удаления строк (CanDeleteRows)

Разрешает удаление строк из таблицы. Тип значения – уведомляющий bool.

Значение:

  • true – удаление строк разрешено;
  • false – удаление строк запрещено.

Чтобы удалить строку, используйте сочетание клавиш Ctrl+Delete.

Возможность перемещения строк (CanMoveRows)

Разрешает перемещение строк в таблице. Тип значения – уведомляющий bool.

Значение:

  • true – перемещение строк разрешено;
  • false – перемещение строк запрещено.

Чтобы переместить строку, используйте сочетание клавиш:

  • Ctrl+↑ для перемещения выше;
  • Ctrl+↓ для перемещения ниже.

В режиме редактирования (InEditMode)

Предоставляет информацию о состоянии редактирования значения ячейки. Тип значения – уведомляющий bool.

Только для чтения в режиме рантайма.

Значение:

  • true – в данный момент редактируется значение какой-либо из ячеек;
  • false – в данный момент редактирование значений ячеек не выполняется.

Текущая строка (CurrentRow)

Предоставляет номер строки выделенной ячейки. Тип значения – уведомляющий int4.

Только для чтения в режиме рантайма.

Текущий столбец (CurrentColumn)

Предоставляет номер столбца выделенной ячейки. Тип значения – уведомляющий int4.

Только для чтения в режиме рантайма.

Декорировать таблицу (pSetDecorator)

Ссылка на команду, определяющую настройки декоратора таблицы.

По умолчанию указана ссылка на команду, декорирующую таблицу.

Событие нажатия клавиши (pKeyPress)

Ссылка на Обработчик события, выполняемый при нажатии клавиши в редактируемой таблице.

По умолчанию указана ссылка на обработчик события, выполняющий:

  • если в данный момент редактируется значение ячейки, а значит свойство В режиме редактирования (InEditMode) принимает значение true:

    • по нажатию клавиши Enter – завершение редактирования ячейки с сохранением значения;
    • по нажатию клавиши Esc – завершение редактирования ячейки без сохранения значения.
  • если в данный момент не редактируется значение ячейки, а значит свойство В режиме редактирования (InEditMode) принимает значение false:

    • по нажатию клавиши F2 или любого символа – переход в режим редактирования ячейки;
    • по нажатию клавиши Insert при условии, что свойство Возможность добавления строк принимает значение true – добавление новой строки;
    • по нажатию клавиши Delete при условии, что свойство Поведение выделения принимает значение Выделять строки – удаление выделенных строк;
    • по нажатию клавиши Delete при условии, что свойство Поведение выделения принимает значение Выделять элементы – очистку содержимого ячеек;
    • по нажатию клавиш Ctrl+Delete при условии, что свойство Поведение выделения принимает значение Выделять элементы – удаление строк, содержащих выделенные ячейки.

Если переопределить ссылку на обработчик события, указанный по умолчанию, то в таком обработчике можно использовать аргументы возникшего события. Эти аргументы хранятся в виде JSON-строки в Буфере аргументов события. Получить их можно в обработчике события с помощью функции Args.Get().

Пример JSON-строки, содержащей аргументы события, возникшего по нажатию клавиши 5 в редактируемой таблице

{
 "keyCode": 5,
 "modifiers": 0
}

Здесь:

  • keyCode – код нажатой клавиши. Полный список кодов клавиш приведён в Справочном руководстве на Alpha.HMI → Компоненты окружения → Оборудование: клавиатура → Функции → подраздел Коды клавиш.
  • modifiers – код клавиш-модификаторов (например, Ctrl, Shift, Alt), которые были зажаты в момент события. Если нажаты несколько таких клавиш, их значения суммируются. Полный список кодов модификаторов приведён в Справочном руководстве на Alpha.HMI → Компоненты окружения → Оборудование: клавиатура → Функции → подраздел Комбинации модификаторов.

Вставить новую строку (pInsertNewRow)

Ссылка на команду, выполняемую при попытке вставить новую строку в таблицу.

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

Если переопределить ссылку команду, указанную по умолчанию, то при попытке вставить новую строку будет выполнена новая команда, а строка добавлена не будет. Чтобы добавить строку программно, используйте функцию InsertRowAfterSelection().

Удалить выделенные строки (pRemoveSelectedRows)

Ссылка на команду, выполняемую при попытке удалить выбранную строку из таблицы.

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

Если переопределить ссылку команду, указанную по умолчанию, то при попытке удалить выбранную строку будет выполнена новая команда, а строка удалена не будет. Чтобы удалить строку программно, используйте функцию RemoveRows().

Переместить выше (pUpSelectedRows)

Ссылка на Пользовательскую команду, активируемую при перемещении строки выше. Чтобы использовать это свойство, установите значение true для свойства Возможность перемещения строк (CanMoveRows).

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

Если переопределить ссылку, указанную по умолчанию, то при попытке переместить строку выше будет выполнена новая команда, а перемещение строки выше выполнено не будет.

Переместить ниже (pDownSelectedRows)

Ссылка на Пользовательскую команду, активируемую при перемещении строки ниже. Чтобы использовать это свойство, установите значение true для свойства Возможность перемещения строк (CanMoveRows).

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

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

Копировать (pCopyToClipboard)

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

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

Если переопределить ссылку, указанную по умолчанию, то при попытке скопировать текст выделенных ячеек таблицы будет выполнена новая команда, а в буфер обмена не будет помещен текст этих ячеек.

Начать редактирование (pStartEdit)

Ссылка на Обработчик события, активируемый в момент начала редактирования ячейки.

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

Если переопределить ссылку, указанную по умолчанию, то при попытке редактировать значение будет выполнена новая команда, а проверка возможности редактирования и само редактирование значения выполнены не будут. В указанный обработчик в виде json-объекта будут переданы следующие аргументы:

{
 'row': <номер строки>,
 'column': <номер столбца>,
 'value': <текст, введенный пользователем>
}

Получить аргументы в обработчике можно с помощью функции Args.Get() обработчика событий. Подробнее об этом – в описании типа Обработчик события.

Переопределение ссылки на обработчик события может понадобиться для изменения вида редактора значения ячейки и перечисления возможных значений в этом редакторе. Для этого используйте функцию StartEditCell(). В качестве входного параметра укажите JSON-строку:

{
 'row': <номер строки>,
 'column': <номер столбца>,
 'dataType': <тип данных>,
 'value': <редактируемое значение>,
 'values': <массив значений для выпадающего списка>,
 'editorType': <тип редактора: 0 - текстовый, 1 - выпадающий список, 2 - флаг, 3 – целого числа, 4 – даты и времени, 5 – даты, 6 – времени>
}

Поля row и column обязательны. Остальные указываются в зависимости от задачи:

  • Для изменения вида редактора укажите одно из следующих значений для свойства editorType:
    • 0 – текстовый редактор;
    • 1 – редактор в виде выпадающего списка;
    • 2 – редактор в виде флага;
    • 3 – редактор целого числа;
    • 4 – редактор даты и времени;
    • 5 – редактор даты;
    • 6 – редактор времени.

    Обратите внимание, что можно создавать собственные редакторы – с помощью типа Редактор ячейки таблицы. Если в вашем проекте создан собственный редактор, то значение для него указано в его свойстве Тип редактора (EditorType).

  • Перечень возможных значений должен быть указан в качестве массива-значения свойства values.

Проверить значение (pValidateValue)

Ссылка на Обработчик события, проверяющий соответствие значения ячейки типу данных.

Завершить редактирование (pFinishEdit)

Ссылка на команду, выполняемую при завершении редактирования значения ячейки:

  • при потере фокуса у редактора – с сохранением отредактированного значения.
  • при нажатии клавиши Enter – с сохранением отредактированного значения.

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

Если переопределить ссылку, указанную по умолчанию, то при завершении редактирования будет выполнена новая команда, а проверка и установка значения выполнены не будут. Чтобы присвоить значение ячейке программно, используйте функцию SetCellData() текущего экземпляра типа Таблица: модель данных. Пример вызова функции:

EditableTable.TableModel.SetCellData(row,column,Editor.Value);

Сделаны изменения (pChanged)

Ссылка на команду, выполняемую при внесении изменений в таблицу.

По умолчанию указана ссылка на команду, не выполняющую никаких действий.

Редактор ячейки таблицы (pEditor)

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

По умолчанию указана ссылка на стандартный тип редактора, который можно менять (текстовый редактор, редактор в виде выпадающего списка, редактор в виде флага, редактор целого числа, редактор даты и времени, редактор даты и редактор времени). Подробнее об этом – в описании свойства-ссылки Начать редактирование (pStartEdit).

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

Внешний вид изменен (pViewChanged)

Ссылка на команду, выполняемую при изменении внешнего вида таблицы.

Под внешним видом на данный момент подразумевается только ширина столбцов.

Ширина столбца изменена (pColumnWidthChanged)

Ссылка на Обработчик события, активируемый при изменении ширины столбцов.

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

Если переопределить ссылку, указанную по умолчанию, то при изменении ширины столбца будет активирован указанный экземпляр обработчика события, и в него в виде json-объекта будут переданы следующие аргументы:

{
 'index': <идентификатор столбца>,
 'width': <новая ширина столбца>
}

Получить аргументы в обработчике можно с помощью функции Args.Get() обработчика событий. Подробнее об этом – в описании типа Обработчик события.

Переопределение ссылки на обработчик события можно использовать для сохранения внешнего вида таблицы.