Alpha.Community

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

Типизация объектов

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

Тип объекта – это шаблон, который определяет структуру, свойства и поведение объектов. Аналогично классу в объектно-ориентированном программировании, тип описывает характеристики всех экземпляров (объектов), созданных на его основе.

Типы объектов могут быть как визуальными (отображаются на экранных формах), так и невизуальными.

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

При создании нового типа можно выбрать один из двух подходов:

  • Создать пустой тип.
  • Создать тип на основе существующего объекта.

Создание пустого типа

Чтобы создать новый тип:

  1. На панели инструментов нажмите кнопку Создать тип или глобальный объект.

  2. В открывшемся окне выберите нужный тип, например, Графический объект и нажмите Создать.

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

Наведите курсор на тип, чтобы увидеть всплывающую подсказку с информацией о базовом типе и отображаемом имени:

Создание типа на основе существующего объекта

Создание типа на основе существующего создаёт дочерний тип, который наследует от родительского (базового) типа структуру элементов и значения свойств. Изменения, внесённые в базовый тип, автоматически применяются ко всем дочерним типам. При необходимости в дочернем типе можно переопределить отдельные свойства, не затрагивая базовый тип и другие наследники.

Чтобы создать тип на основе уже существующего объекта:

  1. В Библиотеке компонентов щёлкните правой кнопкой мыши на объекте, который хотите использовать как основу.
  2. В контекстном меню выберите команду Создать тип на основе.

Альтернативный способ:

  1. На панели инструментов нажмите кнопку Создать тип или глобальный объект.
  2. В открывшемся окне выберите существующий тип элемента и нажмите Создать.

Если вы хотите найти все дочерние типы выбранного типа, щёлкните правой кнопкой мыши на типе и выберите команду Найти все дочерние типы.

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

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

Чтобы создать копию типа:

  1. В Библиотеке компонентов щёлкните правой кнопкой мыши на нужном типе.
  2. В контекстном меню выберите команду Создать копию объекта.

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

Добавление описаний

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

После добавления экземпляра (объекта) типа на форму, описание будет отображаться рядом с именем экземпляра в области Структура объекта.

Редактирование типа

Для редактирования типа дважды щёлкните по нему в библиотеке компонентов или выделите его и нажмите Enter.

Для редактирования типа конкретного экземпляра выделите его и нажмите F12 (или выберите в контекстном меню Перейти к базовому типу).

Для удобства навигации в иерархиях доступен пункт меню Перейти к ..., который открывает дерево наследования от базового типа до выбранного экземпляра.

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

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

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

Поиск экземпляров типа

Чтобы найти все экземпляры выбранного типа:

  1. В Библиотеке компонентов или окне Структуре объекта щёлкните правой кнопкой мыши на типе.
  2. Выберите команду Найти все экземпляры типа.

  3. В открывшемся окне отобразятся найденные экземпляры.

Альтернативный способ:

  1. В библиотеке компонентов щёлкните правой кнопкой мыши и выберите команду Найти объекты.

  2. В открывшемся окне отметьте флажок Экземпляры и нажмите Найти.

Смена типа

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

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

  3. В открывшемся списке выберите новый базовый тип для выбранных экземпляров.

Если в выделении присутствуют объекты разных групп (например, графический объект и линия), команда Сменить тип неактивна. В таком случае выделите только объекты одного типа.

Добавление подсказок

Чтобы добавить произвольное дополнительное описание экземпляру типа, используйте свойство Отображаемое имя.

Благодаря наличию отображаемого имени можно обращаться к объектам в коде по англоязычному имени, ориентируясь среди объектов при помощи подсказок с отображаемым именем.

Чтобы включить отображение подсказок, нажмите кнопку Отобразить подсказки на панели инструментов или выберите в верхнем меню Вид→ Отобразить подсказки.

В подсказках будет показано значение свойства Отображаемое имя каждого элемента.

Компиляция типа

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

  • В Библиотеке компонентов щёлкните правой кнопкой мыши на типе и выберите Скомпилировать.

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

  • Откройте тип для редактирования, после чего запустите компиляцию текущего типа одним из способов:

    • В меню Проект выберите пункт Запуск компиляции текущего типа.

    • Нажмите кнопку Скомпилировать текущий тип на панели инструментов.

    • Используйте сочетание клавиш Ctrl+F5.

Работа с параметрами инициализации

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

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

  • Значения примитивных типов (Создать → Параметр инициализации → Примитивный тип → <Имя типа>);
  • Ссылки на объекты стандартной библиотеки компонентов (Создать → Параметр инициализации →<Объект библиотеки>);
  • Ссылки на объекты графических типов (Создать → Параметр инициализации → <Имя графического типа>).

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

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

Далее кратко описан пример (скачать его можно здесь) создания и использования задвижки с параметром инициализации в проекте 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.

Удаление неиспользуемых типов

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

  1. В окне Ошибки вызовите контекстное меню для предупреждений Тип не используется в проекте.

  2. Выберите команду Перейти к неиспользуемым типам.

  3. После выполнения команды в Библиотеке компонентов автоматически выделятся все неиспользуемые типы. Нажмите клавишу Delete, чтобы удалить их.