GetCustomProperties
Запрашивает значения пользовательских свойств сигнала. Функция не возвращает данные напрямую. Вместо этого она инициирует запрос, результат которого можно отслеживать через событие OnGetCustomPropertiesFinished.
uint4 GetCustomProperties(string RequestParameters)
|
Параметры
|
Параметр
|
Тип
|
Описание
|
|
RequestParameters
|
string
|
JSON-строка, содержащая массив идентификаторов пользовательских свойств для запроса (например, [1000001, 1000002]). Если передан пустой массив [], запрашиваются все доступные пользовательские свойства сигнала.
|
Возвращаемое значение
|
Параметр
|
Тип
|
Описание
|
|
requestId
|
uint4
|
Идентификатор запроса. Используется, чтобы сопоставить вызов метода и результат, полученный в событии OnGetCustomPropertiesFinished.
|
Примеры
Запросить пользовательские свойства сигнала с идентификаторами 1000001 и 1000002 и вывести полученные значения в текстовое поле.
// Поле myRequestId (тип uint4) предварительно создано
jsonParams: string = "[1000001, 1000002]";
myRequestId = ApItemUInt4_1.GetCustomProperties(jsonParams);
Text_1.Text = "Запрос пользовательских свойств отправлен. ID: " + String.ToString(myRequestId:);
|
if (requestId == myRequestId)
ㅤㅤ// Только если requestId совпадает, выводим результат
ㅤㅤText_2.Text = "Полученные свойства:\n" + result;
|