Alpha.Community

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

Создание собственных функций

Собственные функции в Alpha.HMI расширяют функциональность экранных форм, собственных типов или объектов стандартной библиотеки. Они позволяют задавать свою логику, например, через выполнение кода на Alpha.Om или JavaScript в редакторе кода.

Как создать собственную функцию

Чтобы создать собственную функцию:

  1. Щёлкните правой кнопкой мыши по форме (например, MainForm) в области Структура объекта и в контекстном меню выберите Создать функцию.

  2. Дважды щёлкните левой кнопкой мыши по созданной функции, чтобы открыть Редактор функции.

  3. В окне Редактор функции:

    1. Укажите тип данных, который функция будет возвращать. Если функция не возвращает значение, выберите void.

    2. Задайте имена аргументов и их типы данных. Например: pressure: float.

    3. Установите флажок Ссылка для аргументов, которые нужно передавать по ссылке.

    4. Выберите тип действия, например, Выполнить код (действие позволяет написать собственный код). Типы действий аналогичны обработчикам событий.

    5. Нажмите кнопку Редактировать в окне Редактор функции, чтобы открыть редактор кода.

    6. Напишите код функции в открывшемся редакторе. Для удобства используйте горячие клавиши, описанные в разделе Приложение D: Горячие клавиши.
  4. После завершения настройки параметров функции и написания её кода нажмите ОК. Теперь функция готова к использованию в проекте.

Как управлять задвижкой с индикаторами состояния через собственные функции (Демо-проект)

Далее представлен пример создания собственной функции для управления задвижкой с индикацией положения (скачать его можно здесь) в проекте Alpha.HMI (проект сделан на языке Alpha.Om).

В примере показано, как:

  • Создать типовую задвижку, которую можно многократно использовать в проекте.
  • Разработать функции Open и Close для переключения состояния задвижки (открытие или закрытие).
  • Настроить индикаторы greenBlinking (зеленый) и redBlinking (красный) для отображения состояния задвижки: зеленый — при открытии, красный — при закрытии.
  • Добавить на форму кнопки для вызова функций Open и Close и ползунок для установки периода мигания индикаторов.
  • Разработать функцию GetPosition для получения координат задвижки с использованием передачи аргументов по ссылке.

В результате будет подготовлена форма, при открытии которой ползунок задаёт скорость мигания индикаторов, кнопка Открыть задвижку включает зеленый индикатор, кнопка Закрыть задвижку — красный, а кнопка Показать положение отображает координаты задвижки.

Создание типа задвижки с индикаторами

  1. В библиотеке компонентов на вкладке Проект щелкните правой кнопкой мыши по разделу Типы и выберите Создать. Откроется мастер создания элементов:

    • В поле Тип элемента выберите Тип;

    • В поле Базовый тип элемента выберите Графический объект из раздела Визуальные.

  2. Дважды щёлкните левой кнопкой мыши по типу Dummy_1, чтобы открыть его.

  3. Из библиотеки компонентов (раздел Визуальные) перетяните элемент Линия и нарисуйте с её помощью задвижку.

  4. Добавьте на задвижку два компонента Мигание.

    • Для первого задайте имя greenBlinking и в свойстве Цвет заливки укажите 0xff55ff00 (зеленый).
    • Для второго задайте имя redBlinking и в свойстве Цвет заливки укажите 0xffff0000 (красный).

Разработка функций Open и Close для управления задвижкой

  1. В структуре объекта щелкните правой кнопкой мыши по типу Dummy_1 и выберите Создать функцию.
  2. Повторите действие, чтобы создать две функции, и задайте им имена:

    • Open для открытия задвижки.

    • Close для закрытия задвижки.

Настройка индикаторов greenBlinking и redBlinking через функции

Для каждой функции (Open и Close) выполните следующие шаги:

  1. В области Структура объекта дважды щёлкните левой кнопкой мыши по функции, чтобы открыть окно Редактор функций.

  2. В окне Редактор функций:

    1. Оставьте тип возвращаемого значения как void (функции не будут возвращать данные).

    2. Добавьте входной аргумент с именем period и типом int4. Этот параметр будет задавать период мигания индикаторов в миллисекундах.

    3. В поле Тип действия выберите Выполнить код , затем нажмите Редактировать.

  3. Введите код:

    • Для функции Open:

      Line_1.greenBlinking.Period = TypeConvert.ToUint4(period);
      Line_1.greenBlinking.Enabled = true;
      Line_1.redBlinking.Enabled = false;

      Здесь период мигания зеленого индикатора устанавливается равным period, зеленый индикатор активируется, а красный отключается.

    • Для функции Close:

      Line_1.redBlinking.Period = TypeConvert.ToUint4(period);
      Line_1.redBlinking.Enabled = true;
      Line_1.greenBlinking.Enabled = false;

      Здесь период мигания красного индикатора устанавливается равным period, красный индикатор активируется, а зеленый отключается.

  4. После завершения настройки функций Open и Close их можно использовать в проекте для управления состоянием задвижки. Функции автоматически включают соответствующий индикатор (зеленый для открытия, красный для закрытия) с заданным периодом мигания.

Добавление кнопок и ползунка для управления задвижкой

  1. Разместите экземпляр типа Dummy_1 на форму MainForm.

  2. Добавьте ползунок на форму и настройте диапазон регулировки периода мигания. Для этого:

    • В свойстве Минимальное значение укажите 1.
    • В свойстве Максимальное значение укажите 100.

  3. Добавьте две кнопки на форму.

    • Для первой в свойстве Текст укажите Открыть задвижку.
    • Для второй в свойстве Текст укажите Закрыть задвижку.
  4. Для кнопки Открыть задвижку настройте обработчик события ButtonPressed. Пример кода:

    Dummy_1_1.Open(Slider_1.Value);
  5. Для кнопки Закрыть задвижку настройте обработчик события ButtonPressed. Пример кода:

    Dummy_1_1.Close(Slider_1.Value);

При нажатии кнопок индикаторы будут показывать состояние задвижки: зеленый будет мигать при открытии, красный — при закрытии. Скорость мигания будет зависеть от положения ползунка.

Разработка функции GetPosition для получения координат задвижки

Для получения координат задвижки создайте функцию с передачей аргументов по ссылке. Для этого:

  1. Перейдите в тип Dummy_1.
  2. В структуре объекта щелкните правой кнопкой мыши по типу Dummy_1 и выберите Создать функцию.
  3. Назовите функцию GetPosition.

  4. Дважды щелкните по GetPosition, чтобы открыть редактор функции.
  5. В редакторе функции:

    1. Задайте два аргумента: x: double и y: double.
    2. Установите флажок Ссылка для каждого аргумента.
    3. В поле Тип действия выберите Выполнить код , затем нажмите Редактировать.

    4. Введите код:

      x = this.X;
      y = this.Y;

      Этот код присваивает аргументам x и y текущие координаты объекта (this.Xи this.Y).

  6. На форме MainForm добавьте кнопку и в свойстве Текст укажите Показать положение.
  7. Добавьте элемент Текст для отображения координат.
  8. Для кнопки Показать положение настройте обработчик ButtonPressed. Пример кода:

    coordX : double = 0;
    coordY : double = 0;
    Dummy_1_1.GetPosition(&coordX, &coordY);
    Text_1.Text = "X: " + String.ToString(coordX) + ", Y: " + String.ToString(coordY);