Alpha.Community

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

Свойства

Значение (Value)

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

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

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

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

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

if (DateTime.Hour(TimeEditor.Value) < 9 || DateTime.Hour(TimeEditor.Value) > 18)
 TimeEditor.Error = "Рабочее время вышло";
else TimeEditor.Error = "Время выбрано";

Описание ошибки (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 – текст клавиши.