Alpha.Community

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

Свойства

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

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

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

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

Значение

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

Координата 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 Объект скрыт.

Включено

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

Редактируемый

bool Editable

Доступность поля выпадающего списка для редактирования.

Значение

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

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

string Tooltip

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

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

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

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

float Width
float Height

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

Текст

string Text

Текст, который виден до нажатия на выпадающий список и появления списка доступных элементов для выбора.

Выбранный индекс

uint4 SelectedIndex

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

Если ни один элемент из списка не выбран, значением будет -1.

Количество элементов

uint4 ItemCount

Текущее количество элементов в выпадающем списке.

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

Количество видимых элементов

uint4 MaxVisibleItems

Максимальное количество элементов, отображаемых одновременно в выпадающем списке.

Режим вставки

uint1 InsertPolicy

Режим вставки новых элементов в выпадающем списке в режиме редактирования.

Свойство Редактируемый должно быть установлено в значение true, чтобы разрешить редактирование выпадающего списка пользователем.

Значение

Без вставки Новые элементы не добавляются в список.
В начало Новые элементы вставляются в начало списка.
Замена выбранного элемента Новый элемент заменяет выбранный элемент.
В конец Новые элементы добавляются в конец списка.
После выбранного элемента Новый элемент добавляется после выбранного элемента.
Перед выбранным элементом Новый элемент добавляется перед выбранным элементом.
По алфавиту Новый элемент добавляется в алфавитном порядке.

Шрифт

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;