Alpha.Community

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

Свойства

Значение (Value)

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

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

Событие изменения значения (pValueChanged)

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

При вводе даты в редакторе проверяется условие: если введенная дата больше текущей, появляется сообщение "Этот день еще не настал", в противном случае – "Дата выбрана". Тогда код обработчика команды:

DateEditor.Error = DateEditor.Value > DateTime.Now() ? "Этот день еще не настал" : "Дата выбрана";

Описание ошибки (Error)

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

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

Событие получения фокуса (pGotFocus)

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

Номер поля с фокусом (LastFocused)

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

Нумерация элементов начинается с 1.

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

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

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

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

{
 "keyCode": 5,
 "modifiers": 0,
 "repeated": false,
 "text": "5"
}

Здесь:

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