Alpha.Community

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

Выполнение скриптов

Чтобы написать скрипт, выполняемый при наступлении какого-либо события, используйте обработчик типа Выполнить код. Для открытия редактора кода нажмите кнопку Редактировать или дважды щелкните на обработчике события.

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

Полный перечень поддерживаемых сочетаний клавиш приведён в разделе Приложение D: Горячие клавиши.

Выбор действия по умолчанию при создании обработчиков

В настройках редактора проекта Alpha.HMI можно задать действие, которое будет устанавливаться по умолчанию при создании новых обработчиков событий.

Чтобы настроить действие по умолчанию:

  1. Перейдите в меню Файл→ Настройки.
  2. Откройте вкладку Редактор проекта.
  3. Укажите нужное действие в поле Действие по умолчанию для обработчика.

Выбор языка

В Alpha.HMI доступны два языка для выполнения пользовательских скриптов:Alpha.Omи JavaScript.

Чтобы выбрать язык по умолчанию для всех редакторов кода:

  1. Перейдите в меню Файл→ Настройки.
  2. Откройте вкладку Редактор кода.
  3. Укажите нужный язык в поле Язык по умолчанию.

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

Alpha.Om

Alpha.Om является единым скриптовым языком для различных программных продуктов Альфа платформы:

  • сервер ввода/вывода Alpha.Server (сигнальная модель данных);
  • среда разработки проектов автоматизации Alpha.DevStudio (объектная модель данных);
  • среда разработки и исполнения визуальной части проектов автоматизации Alpha.HMI (объектная модель данных).

Для подробного ознакомления с возможностями языка и его синтаксисом см. документ Язык Alpha.Om. Общее описание.

В Alpha.HMI язык применяется для исполнения формул, обработчиков функций, обработчиков событий и т.д.

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

JavaScript

Язык JavaScript применяется для расширения стандартных возможностей языкаAlpha.Om. Большинство возможностей языка JavaScript (в соответствии с ECMAScript Language Specification) доступно для применения в Alpha.HMI. Исключение составляют браузерно-ориентированные возможности языка. Используемые в Alpha.HMI встроенные функции JavaScript, методы встроенных объектов или собственные функции могут возвращать значение, обращаться к входным аргументам в функции, а также вызывать другие функции.

Следует помнить, что из-за технологии динамической компиляции, скрипты JavaScript не проверяются на наличие ошибок во время исполнения проекта. Все ошибки и предупреждения, возникающие в ходе исполнения скриптов JavaScript, будут логироваться в области Журнал времени исполнения.

Написание кода

При написании кода доступны следующие возможности:

  • Табуляция — для ввода используйте горячие клавиши Tab, Shift+Tab.
  • Автодополнение — доступны два варианта подстановки:
    • Стандартная подстановка — при выборе элемента из списка клавишей Enter или щелчком левой кнопки мыши происходит вставка с заменой текста справа от курсора (до границы слова).
    • Подстановка "как есть" — при выборе элемента с удержанием клавиши Shift (Shift+Enter или Shift+левая кнопка мыши) происходит вставка без удаления текста справа от курсора.

Обращение к элементам

  • Если имя элемента содержит пробелы или нестандартные символы, к нему нельзя обращаться напрямую как к стандартному идентификатору (this.A). В таком случае нужно использовать синтаксис с кавычками:

    this.$"A"
  • Чтобы обратиться к объекту, расположенному в папке, в коде указывайте только имя объекта без имени папки.

Относительная адресация в Alpha.Om

Чтобы обращаться к объектам на различных уровнях иерархии , используйте при написании скриптов специальные ключевые слова:

  • me или this — обращение к текущему объекту;
  • parent — обращение к родителю текущего объекта;
  • here — обращение к ограничивающему типу (корню иерархии в рамках типа).

Пример относительной адресации

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

В данном примере ограничивающий тип - сама экранная форма (бирюзовый цвет).

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

//окрасить текущий объект в цвет родительского объекта
me.BrushColor = parent.BrushColor;

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

//окрасить текущий объект в цвет ограничивающего типа (цвет самой экранной формы)
me.BrushColor = here.BrushColor;

Настройка внешнего вида кода

Чтобы настроить внешний вид кода по умолчанию, перейдите в меню Файл, выберите Настройки и включите нужные опции на вкладке Редактор кода.

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

Параметры события

Ниже приведен перечень типовых событий, которые встречаются у большинства объектов для построения графических примитивов или пользовательского интерфейса (Линия, Прямоугольник, Эллипс и т.д.).

Вышеперечисленные события имеют параметры с доступом через структуру event:

Параметр Тип Описание
X double Локальная координата объекта по оси Х, в которой возникло событие.
Y double Локальная координата объекта по оси Y, в которой возникло событие.
Buttons int4 Код кнопок мыши, которые были нажаты при возникновении события.
KeyboardModifiers int4 Код клавиш-модификаторов (например, Ctrl, Shift, Alt), которые были зажаты в момент события. Если нажаты несколько таких клавиш, их значения суммируются.
Полный список кодов модификаторов приведён в разделе Комбинации модификаторов.
//Разместить кнопку в месте срабатывания события
Button.X = event.X;
Button.Y = event.Y;
//Записать в текстовое поле код кнопок мыши, которые были зажаты при возникновении события
TextEdit_1.Text = Str.ToString(event.KeyboardModifiers);
//Записать в текстовое поле код клавиш клавиатуры, которые были нажаты при возникновени события
TextEdit_2.Text = Str.ToString(event.Buttons);