Alpha.Community

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

Функции

GetWindowIDbyIndex

Возвращает уникальный идентификатор (ID) формы в группе окон по её порядковому номеру (индексу). Используется для обращения к конкретной форме, например, чтобы отправить ей сообщение через SendMessageByID.

Индексация начинается с 0: первая открытая форма в группе имеет индекс 0, вторая — 1 и так далее.

Синтаксис

string GetWindowIDbyIndex(uint4 idx)

Параметры

idx uint4 Порядковый номер формы в группе окон.

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

string Уникальный идентификатор формы в виде строки.

Примеры

Вывести идентификатор первого окна группу в поле ввода.

TextEdit.Text = WindowGroup_1.GetWindowIDbyIndex(0);

SendMessageByID

Отправляет сообщение конкретной форме, указанной по её уникальному идентификатору (ID).

Синтаксис

void SendMessageByID(string windowID, string messageID, string message)

Параметры

windowID string Строковый идентификатор формы, которой отправляется сообщение. Может быть получен через функцию GetWindowIDbyIndex (для форм по индексу) или через свойство Идентификатор окна компонента Окружение: окно (для текущей формы)
messageID string Строковый идентификатор сообщения, который передаётся в событие MessageReceived компонента Окружение: окно как параметр messageType.
message string Строковые данные сообщения, которые передаются в событие MessageReceived компонента Окружение: окно как параметр messageData. Может быть пустой строкой (""), если дополнительные данные не нужны.

Примеры

Отправить сообщение первому открытому окну в группе (с индексом 0).

WindowGroup_1.SendMessageByID(WindowGroup_1.GetWindowIDbyIndex(0),"update", "refresh");

SendToAll

Отправляет сообщение всем формам в группе одновременно.

Синтаксис

void SendToAll(string messageID, string message)

Параметры

messageID string Строковый идентификатор сообщения, который передаётся в событие MessageReceived компонента Окружение: окно как параметр messageType.
message string Строковые данные сообщения, которые передаются в событие MessageReceived компонента Окружение: окно как параметр messageData. Может быть пустой строкой (""), если дополнительные данные не нужны.

Примеры

Отправить сообщение всем открытым окнам в группе.

WindowGroup_1.SendToAll("systemEvent", "maintenance");