Alpha.Community

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

Разметка мнемосхемы

Alpha.HMI предоставляет набор компонентов для разметки элементов мнемосхемы.

Линейная разметка

Чтобы линейно выравнять объекты внутри контейнера (экранной формы или фигуры), добавьте в контейнер компонент Линейная разметка. Компонент невизуальный и виден только в области Структура объекта. На рисунке ниже показано, как на прямоугольник добавлен компонент Линейная разметка.

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

  • Ориентация – направление выравнивания объектов внутри фигуры или формы:

    • 1 – по горизонтали;
    • 2 – по вертикали.

  • Направление по горизонтали – направление элементов разметки для горизонтальной разметки (для вертикальной разметки не используется):

    • 0 – слева направо (по умолчанию);
    • 1 – справа налево.

  • Направление по вертикали – направление элементов разметки для вертикальной разметки (для горизонтальной разметки не используется):

    • 0 – сверху вниз (по умолчанию);

    • 1 – снизу вверх.

  • Промежуток – расстояние между объектами внутри фигуры или формы.

Плоская разметка

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

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

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

Сворачивание элемента разметки

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

По умолчанию плоская и линейная разметки сворачивают невидимые элементы (элементы, у которых свойство Видимость = false) и исключают их из распределения пространства внутри контейнера. На уровне всей разметки это поведение задаётся свойством Сворачивать невидимые.

Компонент Сворачивание элемента разметки позволяет локально переопределить настройку разметки и явно указать, должен ли конкретный элемент сворачиваться при Видимость = false (исключаться из расчёта пространства) или оставаться на месте, сохраняя занимаемое пространство, независимо от значения свойства Сворачивать невидимые.

На рисунках ниже показаны два контейнера с линейной разметкой, каждый из которых содержит три кнопки. В обоих случаях для второй кнопки установлено свойство Видимость = false, а свойство Сворачивать невидимые для всей разметки в обоих контейнерах установлено в true. Различие заключается в том, как обрабатывается скрытие второй кнопки.

Линейная разметка со сворачиванием элемента Линейная разметка без сворачивания элемента

  • Вторая кнопка исключается из расчёта.
  • Контейнер перераспределяет пространство между оставшимися кнопками.
  • Ко второй кнопке добавлен дочерний компонент Сворачивание элемента разметки со свойством Сворачивать невидимый = false.
  • Кнопка становится невидимой, но продолжает занимать своё место. Несмотря на то что для всей разметки установлено Сворачивать невидимые = true, данная кнопка остаётся в расчёте.
  • Первая и третья кнопки остаются на прежних позициях, перераспределения не происходит.

Использование веса элемента разметки

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

На рисунке ниже представлены примеры того, как компонент Вес элемента разметки влияет на распределение пространства и расположение элементов внутри контейнера для линейной и плоской разметок.

Соотношение объектов 1:3. Свойство Значимость для первой кнопки 1, для второй –1, для третьей – 3.

Плоская разметка с использованием веса элементов Линейная разметка с использованием веса элементов
  • Плоская разметка – в этом случае вес элемента прямо пропорционален его размеру и влияет на его расположение внутри контейнера.
  • Линейная разметка – в этом случае вес элемента определяет размер элемента, не изменяя порядок расположения элементов.

Чтобы настроить вес элемента в разметке, установите свойство Значимость.

Выравнивание элемента разметки

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

Если свойство Ориентация компонента Линейная разметка установлено в значение Горизонтальная, выравнивание задаётся по вертикали (перпендикулярная ось). Доступны следующие варианты:

Сверху По центру Снизу

Если свойство Ориентация компонента Линейная разметка установлено в значение Вертикальная, выравнивание задаётся по горизонтали (перпендикулярная ось). Доступны следующие варианты:

Слева По центру Справа

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

В некоторых случаях может потребоваться расположить элемент точно по центру этой оси — например, при горизонтальной разметке разместить элемент по центру по горизонтали. Для этого используется специальный приём, описанный ниже.

Как разместить элемент по центру вдоль основной оси

В линейной разметке нельзя напрямую задать выравнивание по центру вдоль основной оси (например, по горизонтали, если у компонента Линейная разметка задано свойство Ориентация со значением Горизонтальная). Чтобы обойти это ограничение, используется приём с двумя невидимыми заполняющими элементами:

  1. Добавьте контейнер (например, Прямоугольник) на экранную форму.
  2. Добавьте к нему компонент Линейная разметка.

  3. Установите свойство Ориентация компонента Линейная разметка в значение Горизонтальная.

  4. Добавьте в контейнер элемент, который требуется выровнять, например, кнопку.

  5. Добавьте к кнопке компонент Ограничение размеров элемента разметки.

  6. Установите свойства Максимальная ширина и Максимальная высота в значение 50, чтобы задать предельные размеры кнопки.

  7. Добавьте к кнопке компонент Выравнивание элемента разметки.

  8. Для компонента Выравнивание элемента разметки установите свойство Выравнивание по вертикали в значение По центру.

  9. После настройки выравнивания по вертикали кнопка окажется по центру по высоте контейнера, но по горизонтали всё ещё будет прижата к левому краю (так как основная ось — горизонтальная).

  10. Добавьте два прямоугольника в контейнер:

    • Первый разместите перед кнопкой.

    • Второй разместите после кнопки.

  11. Установите для каждого прямоугольника свойство Стиль пера в значение Нет пера, чтобы они были невидимыми.

В результате контейнер равномерно распределит свободное пространство между этими двумя элементами, и кнопка окажется строго по центру вдоль основной (горизонтальной) оси.

Аналогичный приём работает и для вертикальной разметки (свойство Ориентация = Вертикальная), но заполняющие элементы будут распределять пространство сверху и снизу.

Отступы элемента разметки

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

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

  • Сверху – для установки верхнего отступа;
  • Снизу – для установки нижнего отступа;
  • Слева – для установки левого отступа;
  • Справа – для установки правого отступа.

Ограничение размеров элемента разметки

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

Для задания ограничений размеров элемента в разметке:

  • Используйте свойства Минимальная ширина и Минимальная высота, чтобы установить минимальные размеры элемента.
  • Используйте свойства Максимальная ширина и Максимальная высота, чтобы установить предельные максимальные размеры.

Демо-приложение Применение разметки

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

Ниже показан пользовательский интерфейс окна приложения.

Для разметки кнопок на первый контейнер (прямоугольник Rectangle_1) добавлен компонент Линейная разметка, на второй (прямоугольник Rectangle_2)– компонент Плоская разметка.

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

Для горизонтального выравнивания элементов первого контейнера по левому или правому краю, каждой кнопке был добавлен компонент Выравнивание элемента разметки.

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

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

Чтобы элементы первого контейнера выстроились в горизонтальной ориентации, для кнопки Горизонтальная разметка создайте обработчик событий. Код обработчика на языке Alpha.Om:

Rectangle_1.LinearLayout_1.Orientation = 1;

Чтобы элементы первого контейнера выстроились в вертикальной ориентацию, для кнопки Вертикальная разметка создайте обработчик событий. Код обработчика на языке Alpha.Om:

Rectangle_1.LinearLayout_1.Orientation = 2;

Чтобы промежуток между элементами в первом прямоугольнике принял значение 50px и 20px, для кнопок Промежуток 50px и Промежуток 20px создайте обработчики событий. Код обработчиков на языке Alpha.Om:

Rectangle_1.LinearLayout_1.Gap = 50;
Rectangle_1.LinearLayout_1.Gap = 20;

Чтобы выравнять элементы в первом прямоугольнике по левому или правому краю, для кнопок Выравнять по левому краю и Выравнять по правому краю создайте обработчики событий. Код обработчиков на языке Alpha.Om:

// Выравнивание по левому краю
Rectangle_1.Button_1.LayoutAlignment_1.HorizontalAlignment = 0;
Rectangle_1.Button_2.LayoutAlignment_1.HorizontalAlignment = 0;
Rectangle_1.Button_3.LayoutAlignment_1.HorizontalAlignment = 0;
// Выравнивание по правому краю
Rectangle_1.Button_1.LayoutAlignment_1.HorizontalAlignment = 2;
Rectangle_1.Button_2.LayoutAlignment_1.HorizontalAlignment = 2;
Rectangle_1.Button_3.LayoutAlignment_1.HorizontalAlignment = 2;

Чтобы элементам первого контейнера установить ограничение размеров, для кнопки Применить ограничения создайте обработчик событий. Обработчик конвертирует и передает значение из текстового поля в значение свойства Минимальная ширина и Максимальная высота. Код обработчика на языке Alpha.Om:

// Ограничение минимальной ширины
Rectangle_1.Button_1.LayoutSizeLimits_2.MinWidth = String.ToDouble(LineEdit_5.Text,1);
Rectangle_1.Button_2.LayoutSizeLimits_1.MinWidth = String.ToDouble(LineEdit_5.Text,1);
Rectangle_1.Button_3.LayoutSizeLimits_1.MinWidth = String.ToDouble(LineEdit_5.Text,1);
// Ограничение максимальной высоты
Rectangle_1.Button_1.LayoutSizeLimits_2.MaxHeight = String.ToDouble(LineEdit_6.Text,1);
Rectangle_1.Button_2.LayoutSizeLimits_1.MaxHeight = String.ToDouble(LineEdit_6.Text,1);
Rectangle_1.Button_3.LayoutSizeLimits_1.MaxHeight = String.ToDouble(LineEdit_6.Text,1);

Чтобы элементам первого контейнера задать отступы вокруг элементов, для кнопки Применить отступы создайте обработчик событий. Обработчик конвертирует и передает значение из текстового поля в значение свойства Слева и Справа. Код обработчика на языке Alpha.Om:

// Отступы слева
Rectangle_1.Button_1.LayoutMargins_1.Left = String.ToDouble(LineEdit_7.Text,1);
Rectangle_1.Button_2.LayoutMargins_1.Left = String.ToDouble(LineEdit_7.Text,1);
Rectangle_1.Button_3.LayoutMargins_1.Left = String.ToDouble(LineEdit_7.Text,1);
// Отступы справа
Rectangle_1.Button_1.LayoutMargins_1.Right = String.ToDouble(LineEdit_8.Text,1);
Rectangle_1.Button_2.LayoutMargins_1.Right = String.ToDouble(LineEdit_8.Text,1);
Rectangle_1.Button_3.LayoutMargins_1.Right = String.ToDouble(LineEdit_8.Text,1);

Чтобы элементам второго контейнера установить значимость разметки, для кнопки Применить значимость элементам создайте обработчик событий. Обработчик конвертирует и передает значение из текстового поля в значение свойства Значимость. Код обработчика на языке Alpha.Om:

Rectangle_2.Button_1.LayoutWeight_1 = String.ToDouble(LineEdit_1.Text,1);
Rectangle_2.Button_2.LayoutWeight_1 = String.ToDouble(LineEdit_2.Text,1);