Alpha.Community

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

Открытие экранной формы во фрейме

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

Фреймы, как и другие графические компоненты Alpha.HMI используют объекты GDI. При разработке проектов с большим количеством графических элементов следует учитывать лимиты GDI-объектов Windows. Подробные рекомендации по предотвращению ошибок см. в разделе Решение распространенных проблем.

Пример работы с фреймом

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

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

В результате будет подготовлен проект, который позволит открывать форму Form_1 внутри фрейма, изменять её масштаб и прокручивать содержимое. Работа с Form_1 будет происходить внутри главной формы MainForm.

Открытие экранной формы внутри фрейма

  1. Добавьте на форму компонент Фрейм.

  2. Создайте новую форму, которая будет открываться во фрейме Frame_1. Для этого в Библиотеке компонентов во вкладке Проектщёлкните правым кликом мыши на Экранные формы → Создать форму.

  3. Чтобы форма Form_1 открывалась при клике на фрейм, создайте обработчик события MouseClick для компонента Фрейм:

    • Тип обработчика — Открыть во фрейме.
    • Выберите экранную форму Form_1 из выпадающего списка.
    • Введите имя фрейма — Frame_1, в котором будет открыта форма.

Настройка масштаба с помощью одного значения

  1. Добавьте поле для ввода значения масштаба.

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

  3. Настройте обработчик ButtonPressed для кнопки Button_1, чтобы при её нажатии значение из текстового поля передавалось в функцию SetContentScale. Пример кода на языке Alpha.Om:

    Frame_1.SetContentScale(String.ToDouble(LineEdit_1.Text, 1));

Масштабирование формы по ширине и высоте

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

  1. Добавьте два текстовых поля: одно для ширины и одно для высоты.

  2. Добавьте кнопку для применения этих значений.

  3. Настройте обработчик ButtonPressed для кнопки Button_2, чтобы при её нажатии значения ширины и высоты из текстовых полей передавались в функцию ScaleContentTo. Пример кода на языке Alpha.Om:

    Frame_1.ScaleContentTo(String.ToDouble(LineEdit_2.Text, 1), String.ToDouble(LineEdit_3.Text, 1));

Управление прокруткой содержимого фрейма

Для управления прокруткой содержимого фрейма используются ссылки-агрегаторы Горизонтальная полоса прокрутки окна и Вертикальная полоса прокрутки окна компонента Фрейм.

  1. Добавьте на форму два компонента Полоса прокрутки и переименуйте их: ScrollBar_H — для горизонтальной прокрутки, ScrollBar_V — для вертикальной.

  2. Укажите ссылки на добавленные компоненты через свойства компонента Фрейм:

    • Щёлкните правой кнопкой мыши на свойство Горизонтальная полоса прокрутки окна → выберите Сослаться → выберите ScrollBar_H.
    • Аналогично для свойства Вертикальная полоса прокрутки окна → выберите ScrollBar_V.

    После привязки компоненты ScrollBar_H и ScrollBar_Vполучают значения параметров прокрутки фрейма: диапазон (свойства Минимальное значение, Максимальное значение), текущую позицию (свойство Значение) и шаги перемещения (свойства Одиночный шаг, Страничный шаг).

  3. Добавьте два текстовых поля: для координаты X и для координаты Y.

  4. Добавьте кнопку для применения этих значений.

  5. Настройте обработчик ButtonPressed для кнопки Button_3, чтобы при её нажатии введённые значения передавались в свойство Значение полос прокрутки. Пример кода:

    Frame_1.HorizontalScrollBar.Value = String.ToInt(LineEdit_4.Text, 0);
    Frame_1.VerticalScrollBar.Value = String.ToInt(LineEdit_5.Text, 0);