Alpha.Community

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

Функции

FormX и FormY

Вычисляют координаты заданной точки объекта относительно экранной формы. Точка задаётся в локальной системе координат объекта: начало (0, 0) находится в точке, заданной свойствами X и Y объекта, ось X направлена вправо, ось Y — вниз. Координаты измеряются в пикселях.

Синтаксис

FormX(double X, double Y)
FormY(double X, double Y)

Параметры

X double Координата точки по оси X в локальной системе координат объекта.
Y double Координата точки по оси Y в локальной системе координат объекта.

Примеры

Записать в поля ввода координаты начальной точки объекта (X, Y) относительно экранной формы:

TextEdit1.Text = Object.FormX(0, 0);
TextEdit2.Text = Object.FormY(0, 0);

Найти координаты точки внутри вложенного объекта относительно экранной формы. На форме расположен прямоугольник (Rectangle_1) с координатами (604, 803), внутри него — кнопка (Button_1) с координатами (52, 40) относительно прямоугольника.
В локальной системе координат кнопки задана точка (10, 15):

fX = Rectangle_1.Button_1.FormX(10, 15);   // 604 + 52 + 10 = 666
fY = Rectangle_1.Button_1.FormY(10, 15); // 803 + 40 + 15 = 858

ScreenX и ScreenY

Вычисляют координаты заданной точки объекта относительно экрана монитора. Точка задаётся в локальной системе координат объекта: начало (0, 0) находится в точке, заданной свойствами X и Y объекта, ось X направлена вправо, ось Y — вниз. Координаты измеряются в пикселях.

Синтаксис

ScreenX(double X, double Y)
ScreenY(double X, double Y)

Параметры

X double Координата точки по оси X в локальной системе координат объекта.
Y double Координата точки по оси Y в локальной системе координат объекта.

Примеры

Записать в поля ввода координаты начальной точки объекта относительно экрана монитора:

TextEdit1.Text = Object.ScreenX(0, 0);
TextEdit2.Text = Object.ScreenY(0, 0);

Найти координаты точки внутри вложенного объекта относительно экрана монитора. Форма расположена на экране с координатами (200, 150). На форме расположен прямоугольник Rectangle_1 с координатами (604, 803), внутри него — кнопка Button_1 с координатами (52, 40) относительно прямоугольника.
В локальной системе координат кнопки задана точка (10, 15):

fX = Rectangle_1.Button_1.ScreenX(10, 15);   // 200 + 604 + 52 + 10 = 866
fY = Rectangle_1.Button_1.ScreenY(10, 15); // 150 + 803 + 40 + 15 = 1008

Clear

Полностью удаляет все элементы из выпадающего списка.

Синтаксис

void Clear()

Примеры

Удалить все элементы из выпадающего списка.

ComboBox_1.Clear();

GetItem

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

Синтаксис

string GetItem(int4 itemIndex)

Параметры

itemIndex Индекс элемента в списке, для которого нужно получить текст.

Возвращаемое значение

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

Примеры

Поместить в текстовое поле значение элемента выпадающего списка по его индексу:

selectedText: string = ComboBox_1.GetItem(2);
Text_1.Text= selectedText;

Этот код извлекает текст элемента из выпадающего списка ComboBox_1 по индексу 2 и устанавливает его в текстовое поле Text_1.

IndexOf

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

Синтаксис

int4 IndexOf(string itemText)

Параметры

itemText Текст элемента, для которого необходимо найти индекс в списке.

Возвращаемое значение

Возвращает индекс элемента, соответствующего указанному тексту в выпадающем списке. Если элемент не найден, возвращается значение -1.

Примеры

Получить индекс элемента в выпадающем списке по его тексту:

index: int4 = ComboBox_1.IndexOf("Оператор");

Этот код находит индекс элемента в выпадающем списке ComboBox_1 с текстом Оператор и сохраняет его в переменной index.

SetItem

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

Синтаксис

void SetItem(int4 itemIndex, string itemText)

Параметры

itemIndex Индекс устанавливаемого элемента.
itemText Текст, который будет установлен для выбранного элемента.

Примеры

Заменить текст для элемента из выпадающего списка с индексом 2:

ComboBox_1.SetItem(2, "Новый текст");

Этот код изменяет текст элемента с индексом 2 в выпадающем списке ComboBox_1 на Новый текст.

AddItem

Добавляет новый элемент в конец списка.

Синтаксис

void AddItem(string ItemText)

Параметры

itemText Текст, который будет установлен добавляемому элементу.

Примеры

Добавить новый элемент в выпадающий список:

ComboBox_1.AddItem("Новый элемент");

Этот код добавляет новый элемент с текстом Новый элемент в выпадающий список ComboBox_1.

RemoveItem

Удаляет элемент из списка по индексу.

Синтаксис

void RemoveItem(uint4 itemIndex)

Параметры

itemIndex Индекс элемента, который нужно удалить из списка.

Примеры

Удалить элемент с индексом 2 из выпадающего списка:

ComboBox_1.RemoveItem(2);

Этот код удаляет элемент с индексом 2 из выпадающего списка ComboBox_1.

InsertItem

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

Синтаксис

void InsertItem(int4 index, string text)

Параметры

index

Индекс позиции вставки:

  • Если index меньше или равен 0, элемент будет вставлен в самое начало списка.
  • Если index больше или равен количеству элементов в списке, элемент будет добавлен в конец списка.

Во всех остальных случаях элемент вставляется на указанную позицию, сдвигая текущие элементы вниз.

text Текст, который будет установлен добавляемому элементу.

Примеры

Добавить новый элемент в начало выпадающего списка:

ComboBox_1.InsertItem(0, "Первый элемент");

Добавить новый элемент в конец выпадающего списка:

ComboBox_1.InsertItem(ComboBox_1.ItemCount, "Последний элемент");

Добавить новый элемент на индекс 2 (третье место в списке):

ComboBox_1.InsertItem(2, "Элемент на позиции 2");

Этот код вставляет новый элемент на третье место – перед элементом, который в данный момент находится на индексе 2.