Alpha.Community

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

Массивы

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

Чтобы преобразовать объект в массив, укажите размер массива (количество элементов в массиве) в свойстве Кардинальное число объекта. Достаточно указать значение больше 1.

Каждый элемент в массиве имеет свой индекс. Нумерация элементов массива начинается с 0.

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

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

Пример взаимодействия с массивами

Далее кратко описан пример (скачать его можно здесь) взаимодействия с массивом кнопок в проекте Alpha.HMI с использованием языка Alpha.Om.

В примере показано, как:

  • Создать массив из двух кнопок;
  • Изменить координаты второй кнопки;
  • Установить зеленый цвет для нажатой кнопки;

  • Отобразить в текстовом поле, какая из двух кнопок была нажата.

Создать массив из двух кнопок

  1. Добавьте на экранную форму объект типа Кнопка.

  2. Для организации нескольких кнопок в единый массив настройте свойство Кардинальное число объекта. Для массива из двух кнопок установите значение 2. В структуре объекта автоматически добавляется к имени элемента размер массива в квадратных скобках.

Изменить координаты второй кнопки

Чтобы переместить вторую кнопку в новые координаты перед открытием формы в рантайме, настройте обработчик события Opened:

Button_1[1].X = 170; 
Button_1[1].Y = 110;

В данном коде Button_1[1] обращается к определенному элементу в массиве кнопок по его порядковому номеру, где [1] соответствует второй кнопке в массиве. Установка новых значений для свойств X и Y перемещает эту конкретную кнопку в указанные координаты на экране.

Установить зеленый цвет для нажатой кнопки

Чтобы при нажатии на кнопку она подсвечивалась зеленым цветом, настройте событие ButtonPressed. В структуре объекта выделите компонент Кнопка, перейдите во вкладку События и нажмите на событие ButtonPressed правым кликом мыши→ Добавить обработчик → Выполнить код → Редактировать. В открывшемся окне введите следующий код:

for (i : var = 0; i < Button_1.Length; i += 1) // Цикл проходит по всем кнопкам в массиве Button_1
Button_1[i].BrushColor = 0xffbebebe; // Устанавливает серый цвет для каждой кнопки
Button_1[Index].BrushColor = 0xff00ff00; // Устанавливает зеленый цвет для нажатой кнопки

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

Отобразить в текстовом поле, какая из двух кнопок была нажата

Чтобы отображать информацию о том, какая из двух кнопок была нажата, подготовьте текстовое поле и настройте событие ButtonPressed. В структуре объекта выделите компонент Кнопка, перейдите во вкладку События и нажмите на событие ButtonPressed правым кликом мыши→ Добавить обработчик → Выполнить код → Редактировать. В открывшемся окне введите следующий код:

if (Button_1[Index].Index == 0)
Text_1.Text = "Кнопка 1";
if (Button_1[Index].Index == 1)
Text_1.Text = "Кнопка 2";

Этот код проверяет значение свойства Index нажатой кнопки. Если Index равен 0, то в текстовое поле Text_1 выводится сообщение Кнопка 1. Если Index равен 1, то выводится сообщение Кнопка 2.