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);

Курсор

Cursor

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

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;

Отражение

uint1 Flip

Отражение объекта относительно горизонтальной и вертикальной осей.

Значение

Без отражения Объект отображается без изменений.
По горизонтали Объект отражается по горизонтали, создавая зеркальное отображение относительно вертикальной оси.
По вертикали Объект отражается по вертикали, создавая зеркальное отображение относительно горизонтальной оси
По горизонтали и вертикали Объект отражается одновременно и по горизонтали, и по вертикали, создавая зеркальное отображение относительно обеих осей.

Видимость

bool Visible

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

Значение

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

Непрозрачность

double Opacity

Степень прозрачности графического объекта. Измеряется в диапазоне от 0.0 до 1.0 , где

  • 0.0 - объект полностью прозрачный;
  • 1.0 - объект полностью непрозрачный.

Включено

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

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

Удерживаемая

bool Checkable

Режим поведения кнопки после нажатия. При включённом значении (true) кнопка переходит в состояние фиксации (удержания), аналогично переключателю. При отключённом значении (false) кнопка возвращается в исходное (не нажатое) состояние сразу после отпускания.

Значение

true Кнопка становится удерживаемой: после нажатия сохраняет активное состояние до повторного нажатия.
false Кнопка работает в обычном режиме: нажимается и автоматически отпускается при завершении действия.

Нажата

bool Checked

Текущее состояние кнопки — нажата она или нет. Используется совместно со свойством Удерживаемая, если кнопка работает в режиме фиксации.

Значение

true Кнопка находится в нажатом (активном) состоянии.
false Кнопка не нажата (находится в обычном состоянии).

Текст

string Text

Содержимое текстовой области объекта.

Выравнивание текста

int4 TextAlignment

Значение

33 Слева сверху.
65 Слева снизу.
129 Слева по центру.
34 Справа сверху.
66 Справа снизу.
130 Справа по центру.
36 По центру сверху.
68 По центру снизу.
132 По центру объекта.
40 По всей ширине сверху.
72 По всей ширине снизу.
136 По всей ширине по центру.

Шрифт

string Font

Стиль шрифта. Значение указывается через системное окно Выбор шрифта и преобразуется в строку следующего формата:

family, pointSize, pixelSize, styleHint, weight, style, underline, strikeOut, fixedPitch, reserved, styleName

Параметры:

family string Наименование семейства шрифтов.
pointSize double Размер шрифта в пунктах (кегль).
pixelSize int Размер шрифта в пикселях. Если указан -1, используется pointSize.
styleHint int

Хинт (подсказка) для подбора шрифта, если указанное семейство недоступно:

  • 0 = Helvetica/SansSerif
  • 1 = Times/Serif
  • 2 = Courier/TypeWriter
  • 3 = OldEnglish/Decorative
  • 4 = System (системные)
  • 5 = AnyStyle (любой)
  • 6 = Cursive
  • 7 = Monospace
  • 8 = Fantasy
weight int Вес (насыщенность) шрифта от 0 (тонкий) до 99 (жирный).
style int

Стиль начертания:

  • 0 = Normal (обычный)
  • 1 = Italic (курсив)
  • 2 = Oblique (наклонный)
underline int

Подчёркнутый текст:

  • 0 = false;
  • 1 = true.
strikeOut int

Зачёркнутый текст:

  • 0 = false;
  • 1 = true.
fixedPitch int

Моноширинный шрифт:

  • 0 = false;
  • 1 = true.
reserved int Зарезервировано (не используется, оставлять 0).
styleName string (Опционально) Имя стиля, если шрифт поддерживает именованные стили.

Цвет шрифта

uint4 FontColor

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

Примеры

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

Object.FontColor = 0xffff0000;

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

Object.FontColor = 4294901760;

Цвет шрифта при нажатии

uint4 OnClickFontColor

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

Примеры

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

Object.OnClickFontColor = 0xffff0000;

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

Object.OnClickFontColor = 4294901760;

Цвет шрифта при наведении мыши

uint4 OnHoverFontColor

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

Примеры

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

Object.OnHoverFontColor = 0xffff0000;

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

Object.OnHoverFontColor = 4294901760;

Цвет шрифта при выключении

uint4 DisabledFontColor

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

Примеры

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

Object.DisabledFontColor = 0xffff0000;

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

Object.DisabledFontColor = 4294901760;

Цвет заливки

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
Вертикальные линии 10
Клетка 11
Обратные диагональные линии 12
Прямые диагональные линии 13
Диагональная клетка 14

Примеры

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

Object.BrushStyle = 1;

Стиль заливки при нажатии

uint4 OnClickBrushStyle

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

Примеры

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

Object.OnClickBrushStyle = 1;

Цвет заливки при нажатии

uint4 OnClickBrushColor

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

Примеры

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

Object.OnClickBrushColor = 0xffff0000;

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

Object.OnClickBrushColor = 4294901760;

Стиль заливки при наведении мыши

uint4 OnHoverBrushStyle

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

Примеры

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

Object.OnHoverBrushStyle = 1;

Цвет заливки при наведении мыши

uint4 OnHoverBrushColor

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

Примеры

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

Object.OnHoverBrushColor = 0xffff0000;

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

Object.OnHoverBrushColor = 4294901760;

Стиль заливки при выключении

uint4 DisabledBrushStyle

Стиль заливки объекта, когда он отключён (свойство Включено = false). Доступные стили аналогичны стилям свойства Стиль заливки.

Примеры

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

Object.DisabledBrushStyle = 1;

Цвет заливки при выключении

uint4 DisabledBrushColor

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

Примеры

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

Object.DisabledBrushColor = 0xffff0000;

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

Object.DisabledBrushColor = 4294901760;

Цвет пера

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 OnClickPenColor

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

Примеры

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

Object.OnClickPenColor = 0xff000000;

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

Object.OnClickPenColor = 4278190080;

Стиль пера при нажатии

uint2 OnClickPenStyle

Стиль внешней границы объекта при щелчке левой кнопкой по объекту. Доступные стили аналогичны стилям свойства Стиль пера.

Примеры

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

Object.OnClickPenStyle = 3;

Толщина пера при нажатии

float OnClickPenWidth

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

Примеры

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

Object.OnClickPenWidth = 5;

Цвет пера при наведении мыши

uint4 OnHoverPenColor

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

Примеры

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

Object.OnHoverPenColor = 0xff000000;

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

Object.OnHoverPenColor = 4278190080;

Стиль пера при наведении мыши

uint2 OnHoverPenStyle

Стиль внешней границы объекта при наведении курсора мыши. Доступные стили аналогичны стилям свойства Стиль пера.

Примеры

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

Object.OnHoverPenStyle = 3;

Толщина пера при наведении мыши

float OnHoverPenWidth

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

Примеры

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

Object.OnHoverPenWidth = 5;

Цвет пера при выключении

uint4 DisabledPenColor

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

Примеры

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

Object.DisabledPenColor = 0xff000000;

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

Object.DisabledPenColor = 4278190080;

Стиль пера при выключении

uint2 DisabledPenStyle

Стиль внешней границы объекта, когда он отключён (свойство Включено = false). Доступные стили аналогичны стилям свойства Стиль пера.

Примеры

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

Object.DisabledPenStyle = 3;

Толщина пера при выключении

float DisabledPenWidth

Толщина внешней границы объекта, когда он отключён (свойство Включено = false). Измеряется в пикселях.

Примеры

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

Object.DisabledPenWidth = 5;