Alpha.Community

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

Параметры инициализации

Экземпляры графических типов и экранные формы могут иметь параметры инициализации — начальные значения, которые задают уникальные свойства конкретного экземпляра при запуске формы в рантайме.

Параметрами инициализации объектов могут быть:

  • Значения примитивных типов (из юнита Примитивные типы, например: string, double, int).
  • Ссылки на объекты стандартной библиотеки (из юнитов Базовые, Визуальные, Встроенные и другие).
  • Ссылки на объекты пользовательских типов (из юнитов Типы и Экранные формы).

Создание параметров инициализации

Параметр инициализации создаётся одним из следующих способов:

Через мастер создания элементов

Ниже показано создание параметра инициализации примитивного типа. Для параметров-ссылок на объекты библиотеки или пользовательских типов порядок аналогичен — отличается только выбор базового типа на втором шаге.

В Структуре объекта щёлкните правой кнопкой мыши на объекте и выберите Создать. В открывшемся мастере:

  1. В поле Тип элемента выберите Параметр инициализации.
  2. В поле Базовый тип элемента выберите нужный тип.
  3. Нажмите Создать и переименуйте параметр.

Через преобразование поля или ссылки

Существующее поле или ссылку можно преобразовать в параметр инициализации без пересоздания.

Если параметров инициализации в структуре объекта ещё нет, щёлкните правой кнопкой мыши на поле или ссылке и выберите Преобразовать в → Параметр инициализации.

Если параметры инициализации уже есть, перетащите поле или ссылку в раздел Параметры инициализации в Структуре объекта методом drag-and-drop.

Обратное преобразование выполняется аналогично: перетащите параметр инициализации в раздел Данные.

Смена типа параметра инициализации

Ниже показана смена типа параметра инициализации примитивного типа. Для параметров-ссылок на объекты библиотеки или пользовательских типов порядок аналогичен — отличается только выбор нового типа в открывшемся списке.

Тип созданного параметра инициализации можно изменить без удаления и пересоздания:

  1. Откройте список типов одним из способов:

    • Щёлкните правой кнопкой мыши на параметре в Структуре объекта и выберите Сменить тип.

    • Дважды щёлкните левой кнопкой мыши на типе в столбце Описание в Структуре объекта.

  2. Укажите нужный тип в открывшемся списке.

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

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

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

  • Создать типовую задвижку, которую можно многократно использовать в проекте.
  • Настроить параметр инициализации для типовой задвижки, чтобы передавать уникальные имена её экземплярам.
  • Добавлять созданные экземпляры на экранную форму и задавать для каждого уникальные имена.

В результате будет подготовлена форма, на которой размещены три задвижки. Каждая задвижка отображает своё уникальное имя в текстовом блоке, заданное через параметр инициализации.

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

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

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

  2. Перейдите внутрь созданного типа Dummy_1 двойным нажатием мыши.

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

  4. Добавьте два текстовых элемента из Библиотеки компонентов:

    • Для первого элемента задайте свойству Текст значение Задвижка. Этот текст будет статичным и служить обозначением.
    • Для второго элемента задайте свойству Текст значение *** (три звёздочки). В рантайме это значение автоматически заменится на имя экземпляра задвижки, заданное через параметр инициализации.

Настроить параметр инициализации для типовой задвижки

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

    • В поле Тип элемента выберите Параметр инициализации;
    • В поле Базовый тип элемента выберите Примитивные типы→ string;
    • После создания параметра задайте ему имя, например, SWname.

  2. Выделите элемент Text_2 и в начальное значение его свойства Текст укажите ссылку на SWname. Для этого щелкните правой кнопкой мыши на начальное значение, выберите Сослаться и укажите SWname.

Добавление экземпляров на экранную форму

  1. Перейдите на главную форму проекта MainForm.
  2. Перетащите из библиотеки компонентов 3 экземпляра типа Dummy_1 на форму.

  3. Для каждого экземпляра задайте уникальное имя в параметре SWname через редактор свойств:

    • Для первого экземпляра введите SW1;
    • Для второго – SW2;
    • Для третьего – SW3.