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;

Отражение

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

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

Адрес

string Url

URL веб-страницы или путь к локальному HTML/MHTML-файлу.

Примеры

Задать URL веб-страницы:

WebContent_1.Url = "https://example.com"; // Открытие веб-страницы

Задать путь к локальному MHTML-файлу:

WebContent_1.Url = "file:///C:/Project/page.mhtml"; // Открытие локального MHTML-файла

Показывать контекстное меню

bool ShowContextMenu

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

Значение

true Контекстное меню отображается при правом клике мышью.
false Контекстное меню не отображается.

Показывать диалог сохранения файла

bool ShowDownloadDialog

Отображение диалога сохранения файла.

Значение

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

Путь для сохранения файлов

string DownloadDirectory

Путь к папке, в которую будут сохраняться файлы при выполнении операции сохранения веб-страницы.

Примеры

Задать путь для сохранения файлов:

WebContent_1.DownloadDirectory = "C:/Users/Admin/Documents/Сохраненные_страницы/";