Alpha.Community

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

Свойства

Отображаемое имя

Описание объекта (поля объекта). Позволяет указать произвольное (например, русскоязычное) имя для узнаваемости объекта (поля объекта) в проекте. Не мешает использованию базового англоязычного имени объекта (поля объекта) для обращения в коде.

Кардинальное число

Преобразует объект в массив и задает размер массива (количество элементов в массиве).

Значение

1 Одиночный объект.
>1 Массив соответствующей размерности.

Длина

int8 Length

Размер массива (количество элементов в массиве).

Есть только у массивов и доступно только для чтения в режиме рантайма.

Примеры

Записать в текстовое поле длину массива.

TextEdit_1.Text = Str.ToString (SW_1.Length);

Индекс

int8 Index

Индекс элемента в массиве. Позволяет отследить у какого элемента сработало то или иное событие.

Есть только у массивов и доступно только для чтения в режиме рантайма.

Примеры

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

TextEdit_2.Text = Str.ToString(Index);

Записать в текстовое поле текущее значение элемента массива, у которого сработало событие изменения значения.

TextEdit_3.Text = Str.ToString(penwidth[Index]);

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

if (SW_1.Mode.Index == 0)
TextEdit_1.Text = "Включен режим 1";
else
TextEdit_1.Text = "Включен режим 2";

Координата X и Координата Y

float X
float Y

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

Примеры

Установить позицию элемента (100; 100).

Object.X = 100;
Object.Y = 100;

Сдвинуть объект на 50 пикселей правее и ниже его текущей позиции.

Object.X += 50;
Object.Y += 50;

Координата курсора X и Координата курсора Y

float MouseX
float MouseY

Позиция курсора мыши в локальных координатах объекта. Измеряется в пикселях, как сдвиг относительно левого верхнего угла объекта.

Доступно только для чтения в режиме рантайма.

Примеры

Вывести в текстовую область координаты курсора мыши внутри объекта.

TextEdit.Text = Str.ToString(Object.MouseX);
TextEdit.Text = Str.ToString(Object.MouseY);

Z-значение

float ZValue

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

Диапазон допустимых значений: 0 и выше.

При использовании Alpha.HMI.WebViewer рекомендуется задавать целочисленные значения для свойства Z-значение, так как в Alpha.HMI.WebViewer значение Z-значение автоматически округляется до целого числа.

Угол поворота

float Rotation

Угол поворота объекта. Измеряется в градусах. При указании положительных значений объект поворачивается по часовой стрелке. При указании отрицательных значений объект поворачивается против часовой стрелки.

Примеры

Задать угол поворота объекта - 45 градусов.

Object.Rotation = 45;

Увеличить угол поворот объекта на 1 градус относительно текущего значения

Object.Rotation += 1;

Масштаб

float Scale

Коэффициент масштабирования объекта.

Примеры

Установить полуторный масштаб объекта.

Object.Scale = 1.5;

Увеличить текущий масштаб объекта в 3 раза.

Object.Scale *= 3;

Уменьшить текущий масштаб объекта в 2 раза.

Object.Scale *= 0.5;

Видимость

bool Visible

Видимость объекта на форме.

Значение

true Объект виден.
false Объект скрыт.

Включено

bool Enabled

Активность объекта.

Значение

true Объект активен.
false Объект заблокирован.

Примеры

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

if (Signal1.value == Signal2.value)
  Object.Enabled = true;
else
  Object.Enabled = false;

Фокус ввода

bool Focus

Свойство устарело.

Переводит фокус на объект/снимает фокус с объекта.

Значение

true Фокус на объекте.
false Фокус вне объекта.

Примеры

Записать значение из поля ввода в сигнал при снятии фокуса с объекта.

if (object.Focus == false)
    pressure.Value = String.ToDouble(TextEdit_1.Text, 0);

Всплывающая подсказка

string Tooltip

Подсказка, всплывающая при наведении курсора на объект.

Примеры

Задать всплывающую подсказку для объекта.

Object.Tooltip = "Подача команды MNA_start = true";

Ширина и Высота

float Width
float Height

Ширина и высота объекта в пикселях.

Цвет пера

uint4 PenColor

Цвет внешней границы объекта. Указывается через системное окно Выбор цвета. После выбора автоматически переводится в шестнадцатеричную систему счисления.

Примеры

Задать черный цвет пера в шестнадцатеричной системе счисления.

Object.PenColor = 0xff000000;

Задать черный цвет пера в десятичной системе счисления.

Object.PenColor = 4278190080;

Стиль пера

uint2 PenStyle

Стиль внешней границы объекта.

Значение

Значение в дизайнере Значение в коде Вид границы
Нет пера 0  
Сплошная линия 1
Штриховая линия 2
Пунктирная линия 3
Штрих-пунктирная линия 4
Штрих-пунктирная линия с двумя точками 5

Примеры

Применить стиль границы (короткий пунктир) для объекта.

Object.PenStyle = 3;

Толщина пера

float PenWidth

Толщина внешней границы объекта. Измеряется в пикселях.

Примеры

Задать толщину пера 5 пикселей.

Object.PenWidth = 5;

Цвет заливки

uint4 BrushColor

Цвет внутренней заливки объекта. Указывается через системное окно Выбор цвета. После выбора автоматически переводится в шестнадцатеричную систему счисления.

Примеры

Залить объект красным цветом (цвет в шестнадцатеричной системе счисления).

Object.BrushColor = 0xffff0000;

Залить объект красным цветом (цвет в десятичной системе счисления).

Object.BrushColor = 4294901760;

Стиль заливки

uint2 BrushStyle

Заливает объект одним из стилей заливки.

Значение

Значение в дизайнере Значение в коде Вид границы
Нет заливки 0  
Сплошная заливка 1
Точечная 1 2
Точечная 2 3
Точечная 3 4
Точечная 4 5
Точечная 5 6
Точечная 6 7
Точечная 7 8
Горизонтальные линии 9

Примеры

Залить объект сплошным цветом.

Object.BrushStyle = 1;

Размер сектора

float PieAngle

Угол отображаемого сектора эллипса. Измеряется в градусах.

Начало сектора

float PieAngleStart

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

Размер отверстия

double HoleSize

Размер внутреннего отверстия в эллипсе как доля от размера эллипса.

Диапазон значений:

  • 0 - нет отверстия;
  • больше 0 и меньше 1 - размер отверстия как доля от размера эллипса;
  • 1 - отверстие равно размеру эллипса.

Примеры

Создать эллипс с размером отверстия 30% от размера эллипса:

Ellipse.HoleSize = 0.3;