Alpha.Community

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

Добавление ссылок на другие объекты

Ссылка — это свойство объекта, которое хранит указатель на другой существующий объект (экземпляр типа) в проекте Alpha.HMI. Ссылка не хранит данные целевого объекта напрямую; она лишь указывает на его существующий экземпляр.

Ссылки применяются в следующих случаях:

  • Когда нескольким объектам требуется работать с одним и тем же экземпляром (например, несколько компонентов Элемент АР могут ссылаться на один экземпляр Источник данных АР);
  • Когда необходимо управлять компонентами родительской формы из дочерней формы (например, изменять свойства или вызывать методы компонентов, расположенных на родительской форме).

Создание ссылки на объект

Чтобы создать ссылку на объект:

  1. В Структуре объекта правой кнопкой мыши щелкните на MainForm → Создать. Откроется мастер создания элементов.
  2. В открывшемся мастере создания элементов:
    1. В поле Тип элемента выберите Ссылка.
    2. В поле Базовый тип элемента укажите Тип того объекта, на который будет ссылаться создаваемая ссылка. Например, если ссылка должна указывать на объект типа Индикатор прогресса, выберите Индикатор прогресса.

    3. Нажмите Создать.

Созданная ссылка появится:

  • В разделе Данные в Структуре объекта.

  • В Редакторе свойств родительского объекта как свойство, которому можно присвоить значение.

Чтобы указать конкретный объект, на который будет указывать ссылка:

  1. Найдите свойство-ссылку в одном из следующих мест:

    • В Редакторе свойств созданной ссылки.

    • В Редакторе свойств родительского объекта.

  2. Щёлкните по свойству правой кнопкой мыши.
  3. Выберите Сослаться и укажите целевой объект в проекте.

    Значение достаточно указать в одном месте — оно автоматически отобразится в другом.

Преобразование существующего объекта в ссылку и обратно

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

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

Чтобы преобразовать ссылку обратно в объект:

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

Быстрый переход по ссылке

Для перехода к целевому объекту, на который указывает ссылка:

  1. В Редакторе свойств найдите свойство со ссылкой.
  2. Щёлкните по нему правой кнопкой мыши.

  3. Выберите Перейти по ссылке.

Система автоматически выделит целевой объект в Структуре объекта, и если элемент визуальный, отобразит на мнемосхеме.

Поиск всех начальных значений ссылки

Чтобы найти все места в проекте, где ссылке присвоено начальное значение:

  1. В окне Структура объекта, Обзор или Контрольные значения щёлкните правой кнопкой мыши на ссылке.
  2. Выберите Найти все начальные значения.

Результаты отобразятся в окне Результаты поиска.

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

Как управлять компонентом главной формы из дочернего окна через ссылку

В этом примере показано, как из дочернего окна ControlPanel управлять экземпляром компонента Индикатор прогресса, который находится на главной форме MainForm.

Главная форма MainForm содержит:

  • Индикатор прогресса — целевой объект.
  • Кнопка для открытия дочерней формы ControlPanel.

Дочерняя форма ControlPanel содержит кнопки, меняющие значение индикатора на главной форме: 0%, 50%, 100%.

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

  1. Создайте дочернюю форму ControlPanel:
    1. В Библиотеке компонентов на вкладке Проект щёлкните правой кнопкой мыши на Экранные формы → Создать форму.
    2. Назовите форму ControlPanel.

  2. Создайте ссылку на индикатор прогресса внутри ControlPanel:
    1. В Структуре объекта щёлкните правой кнопкой мыши на ControlPanel → Создать. Откроется мастер создания элементов.
    2. В поле Тип элемента выберите Ссылка, Базовый тип элемента→ Индикатор прогресса→ Создать.

    3. Переименуйте ссылку в ref_ProgressBar.

  3. Добавьте на форму ControlPanel три компонента Кнопка.
  4. Настройте свойство Текст для кнопок:
    1. Первая кнопка: Установить 0%.
    2. Вторая кнопка: Установить 50%.
    3. Третья кнопка: Установить 100%.
  5. Настройте обработчики событий ButtonPressed для кнопок на ControlPanel:
    1. Для кнопки Установить 0% в обработчике ButtonPressed добавьте код:

      ref_ProgressBar.Value = 0;
    2. Для кнопки Установить 50% в обработчике ButtonPressed добавьте код:

      ref_ProgressBar.Value = 50;
    3. Для кнопки Установить 100% в обработчике ButtonPressed добавьте код:

      ref_ProgressBar.Value = 100;
  6. Добавьте на форму MainForm следующие компоненты:
    • Индикатор прогресса. 

    • Кнопка.

  7. Настройте свойства для компонента Индикатор прогресса :

    • Минимальное значение: 0.

    • Максимальное значение: 100.

  8. В свойстве Текст кнопки укажите: Открыть ControlPanel.
  9. Для события ButtonPressed кнопки укажите:

    1. Тип обработчика: Открыть в новом окне.
    2. Форма по идентификатору: ControlPanel.

    3. В дереве обработчика разверните узел Handler_1 — отобразятся все параметры формы ControlPanel.

      1. Щёлкните правой кнопкой мыши на параметре ref_ProgressBar.
      2. Выберите Сослаться и укажите here.ProgressBar_1 (это передаст в ControlPanel текущий экземпляр Индикатор прогресса в качестве значения параметра ref_ProgressBar).

Как управлять родительской формой из дочерней через ссылку

В этом примере показано, как из дочернего окна ChildForm управлять родительским окном MainForm: скрывать его, показывать снова или полностью закрывать. Главная форма открывает дочернюю форму по нажатию кнопки, а на дочерней форме расположены три кнопки управления родительской формой.

После запуска главной формы в рантайме:

  • Отображается главная форма MainForm с кнопкой Открыть ChildForm.
  • При нажатии на кнопку открывается дочерняя форма ChildForm в отдельном окне.

На дочерней форме три кнопки:

  • Скрыть главную форму — MainForm исчезает с экрана.
  • Показать главную форму — MainForm снова появляется.
  • Закрыть главную форму — MainForm полностью закрывается.

Дочерняя форма управляет родительской через ссылку на экземпляр MainForm.

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

  1. Создайте дочернюю форму ChildForm:
    • В Библиотеке компонентов на вкладке Проект щёлкните правой кнопкой мыши на Экранные формы → Создать форму.
    • Назовите форму ChildForm.

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

    3. Переименуйте созданную ссылку в ref_MainForm.

  3. Добавьте на форму ChildForm три компонента Кнопка.
  4. Настройте свойство Текст для кнопок:
    1. Первая кнопка: Скрыть главную форму.
    2. Вторая кнопка: Показать главную форму.
    3. Третья кнопка: Закрыть главную форму.
  5. Настройте обработчики событий ButtonPressed для кнопок на ChildForm:
    1. Для кнопки Скрыть главную форму в обработчике ButtonPressed добавьте код:

      ref_MainForm.Hide();
    2. Для кнопки Показать главную форму в обработчике ButtonPressed добавьте код:

      ref_MainForm.Show();
    3. Для кнопки Закрыть главную форму в обработчике ButtonPressed добавьте код:

      ref_MainForm.Close();
  6. На форму MainForm добавьте компонент Кнопка.
  7. В свойстве Текст кнопки укажите: Открыть ChildForm .
  8. Для события ButtonPressed кнопки укажите:

    1. Тип обработчика: Открыть в новом окне.
    2. Форма по идентификатору: ChildForm.

    3. В дереве обработчика разверните узел Handler_1 — отобразятся все параметры формы ChildForm.

      1. Щёлкните правой кнопкой мыши на параметре ref_MainForm.
      2. Выберите Сослаться и укажите here (это передаст текущий экземпляр MainForm в качестве значения параметра ref_MainForm для ChildForm).