Alpha.Community

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

События

OnDrop

Событие срабатывает, когда на стороне объекта-получателя завершилась операция перетаскивания (когда пользователь отпускает кнопку мыши над объектом-получателем).

Параметры

data

Объект, содержащий переданные данные и методы для их извлечения.

Объект data предоставляет набор методов для получения переданных данных в различных форматах:

GetText

Извлекает текстовое содержимое, которое было установлено на стороне отправителя функцией SetText(). Если текстовые данные не передавались, возвращает пустую строку.

Синтаксис

string GetText()

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

string Строковое значение переданного текста.

Примеры

Настроить обработчик события OnDrop, чтобы при перетаскивании текста он отображался в компоненте Text_2.

// В обработчике события OnDrop
receivedText: string = data.GetText();
if (receivedText != "")
{
ㅤText_2.Text = "Получен текст: " + receivedText;
}

GetHtml

Извлекает HTML-содержимое, которое было установлено на стороне отправителя функцией SetHtml(). Если HTML-данные не передавались, возвращает пустую строку.

Синтаксис

string GetHtml()

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

string Строковое значение переданного HTML-содержимого

Примеры

Настроить обработчик события OnDrop, чтобы при перетаскивании HTML-содержимого оно отображалось в компоненте Text_2.

// В обработчике события OnDrop
receivedHtml: string = data.GetHtml();
if (receivedHtml != "")
{
ㅤㅤ// Отобразить HTML-содержимое
ㅤㅤText_2.Html = receivedHtml;
}

GetData

Извлекает типизированные данные по указанному типу, которые были установлены на стороне отправителя функцией SetData(). Если данные указанного типа не передавались или тип не разрешен для приема, возвращает пустую строку.

Синтаксис

string GetData(string userType)

Параметры

userType string

Строковый идентификатор типа данных.

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

string Строковое значение данных указанного типа

Примеры

Настроить обработчик события OnDrop для получения данных разных типов и отображения их в соответствующих компонентах.

// В обработчике события OnDrop
tagName: string = data.GetData("tag");
description: string = data.GetData("description");
units: string = data.GetData("units");
if (tagName != "")
{
ㅤㅤText_Tag.Text = tagName;
}
if (description != "")
{
ㅤㅤText_Description.Text = description;
}
if (units != "")
{
ㅤㅤText_Units.Text = units;
}

GetDataSize

Возвращает размер массива бинарных данных указанного типа. Используется для определения количества элементов в массиве перед его чтением с помощью GetDataAt().

Синтаксис

uint4 GetDataSize(string userType)

Параметры

userType string

Строковый идентификатор типа данных.

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

uint4 Размер массива (количество элементов)

Примеры

Получить размер переданного массива и отобразить информацию о нем.

// В обработчике события OnDrop
arraySize: uint4 = data.GetDataSize("measurements");
if (arraySize > 0)
{
ㅤㅤText_Info.Text = "Получен массив из " + String.ToString(arraySize) + " элементов";
}
else
{
ㅤㅤText_Info.Text = "Массив данных не получен";
}

GetDataAt

Извлекает значение элемента массива бинарных данных по указанному индексу. Перед вызовом рекомендуется определить размер массива с помощью GetDataSize() для избежания выхода за границы массива.

Синтаксис

uint1 GetDataAt(string userType, uint4 idx)

Параметры

userType string

Строковый идентификатор типа данных.

idx uint4 Индекс элемента в массиве (начиная с 0).

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

uint1 Байтовое значение (0-255) элемента массива

Примеры

Прочитать все элементы переданного массива и вычислить их среднее значение.

// В обработчике события OnDrop
arraySize: uint4 = data.GetDataSize("sensorData");
if (arraySize > 0)
{
ㅤㅤtotalSum: uint4 = 0;
ㅤㅤfor (i: uint4 = 0; i < arraySize; i += 1)
ㅤㅤ{
ㅤㅤㅤㅤelement: uint1 = data.GetDataAt("sensorData", i);
ㅤㅤㅤㅤtotalSum += element;
ㅤㅤ}
ㅤㅤaverage: uint4 = totalSum / arraySize;
ㅤㅤText_Average.Text = "Среднее значение: " + String.ToString(average);
}