Alpha.Community

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

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

Используется для создания собственных редакторов значений ячеек для экземпляра типа Редактируемая таблица.

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

Чтобы использовать редактор собственного типа в таблице, выполните следующие действия (подробный пример действии по инструкции приведен ниже):

  1. Создайте собственный тип на основе типа Редактор ячейки таблицы.
  2. Задайте идентификатор созданного типа: для свойства Тип редактора (EditorType) укажите значение больше 6 (типы редакторов от 0 до 6 – это стандартные редакторы).
  3. Опишите в созданном типе редактор, посредством которого будет выполняться выбор значения.
  4. Настройте запись выбранного в элементе значения в ячейку таблицы с помощью свойства Редактируемое значение (EditedValue) созданного типа.
  5. Добавьте в экземпляр типа Редактируемая таблица экземпляр созданного вами типа редактора.
  6. Переопределите поведение этой таблицы в момент начала редактирования значения ячейки. Для этого:
    1. Создайте экземпляр типа Обработчик события. В обработчике события Invoked созданного экземпляра вызовите функцию StartEditCell() редактируемой таблицы. В качестве входного параметра укажите JSON-строку с:

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

        Пусть при редактировании любой ячейки в первом столбце таблицы (cellInfo.column == 0) должен открываться собственный редактор, идентификатор которого равен десяти. Вместе с тем массив допустимых значений, вводимых пользователем, указан в качестве значения свойства PossibleValues типа, созданного на основе типа Редактор ячейки таблицы. Тогда код обработчика события Invoked экземпляра типа Обработчик события может выглядеть следующим образом:

        var cellInfo = JSON.parse(Args.Get());
        if (cellInfo.column == 0)
        {
         cellInfo.values = JSON.parse(My_Editable_Table.My_Redactor.PossibleValues);
         cellInfo.editorType = 10;
        }
        StartEditCell(JSON.stringify(cellInfo));
    2. Для экземпляра редактируемой таблицы переопределите:
      • Значение свойства Редактор ячейки таблицы (pEditor) – укажите здесь ссылку на экземпляр созданного вами типа редактора.
      • Значение свойства Начать редактирование ячейки (pStartEdit) – укажите здесь ссылку на созданный вами обработчик события.

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

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

  1. Создайте собственный тип на основе типа Редактор ячейки таблицы. Пусть имя созданного редактора – MyRedactor.

  2. Задайте идентификатор редактора MyRedactor: для свойства Тип редактора (EditorType) укажите значение больше 6, например, 10.

  3. Опишите в MyRedactor сам редактор, посредством которого будет выполняться выбор значения.

    Пусть собственный редактор ячейки должен представлять собой Диалог выбора цвета. В MyRedactor следует поместить экземпляр типа Команда, который будет открывать диалог, например, Action_Open. В обработчике события Invoked команды Action_Open укажите команду открытия диалога.

    Добавьте здесь же экземпляр типа Результат выбора цвета, назовите его ColorDialogResult и укажите ссылку на него из свойства Ссылка на результат диалога выбора цвета (свойства диалога доступны в команде Action_Open при разворачивании обработчика события Invoked). Подробнее об этом – на странице описания компонента Диалог выбора цвета.

  4. Настройте запись выбранного в редакторе значения в ячейку таблицы с помощью свойства Редактируемое значение (EditedValue).

    Пусть при нажатии кнопки ОК в диалоге выбора цвета в свойство Редактируемое значение экземпляра MyRedactor записывается текстовое значение выбранного цвета.

    1. Внутри MyRedactor создайте команду, например, Action_OK. В обработчике команды Invoked созданной команды укажите код:

      EditedValue = String.ToString(ColorDialogResult.Color); // присвоение значения выбранного цвета свойству
      Apply = true; // применение выбранного значения ячейке таблицы
    2. Из свойства OkAction диалога выбора цвета сделайте ссылку на созданную команду Action_OK (свойства диалога доступны в команде Action_Open при разворачивании обработчика события Invoked).

    Полученное здесь значение в дальнейшем можно будет использовать, например, для заливки ячейки выбранным цветом (как это сделать, здесь не описано: обратитесь к руководству пользователя Alpha.HMI и ознакомьтесь с возможностями изменения внешнего вида таблиц с помощью компонента Декоратор).

  5. Добавьте в экземпляр типа Редактируемая таблица экземпляр созданного вами типа редактора. Для этого перетащите MyRedactor из библиотеки компонентов в нужную таблицу, имя которой, например, MyTable.
  6. Переопределите поведение таблицы MyTable в момент начала редактирования значения ее ячейки. Для этого:

    1. Создайте экземпляр типа Обработчик события, например StartEditNewCell. В обработчике события Invoked созданного экземпляра вызовите функцию StartEditCell() таблицы MyTable, например:

      var cellInfo = JSON.parse(Args.Get()); // получение информации о текущей ячейке
      if (cellInfo.column == 0) // если текущая ячейка находится в первом столбце
      {
       cellInfo.editorType = 10; // тип редактора ячейки – 10 (диалог выбора цвета)
       MyRedactor_1.Action_Open.Invoke(); // вызов команды, открывающей диалог выбора цвета из редактора
      }
      StartEditCell(JSON.stringify(cellInfo)); // команда начала редактирования ячейки
    2. Для свойств таблицы MyTable переопределите:
      • Значение свойства Редактор ячейки таблицы (pEditor) – укажите здесь ссылку на экземпляр типа MyRedactor, добавленный в таблицу.
      • Значение свойства Начать редактирование ячейки (pStartEdit) – укажите здесь ссылку на созданный вами обработчик события StartEditNewCell.