Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.25. Вспомогательный объект для изменения структуры переменных блока

А.5.25.2. rdsVSAddAutoConn – добавить связь с управляющей переменной

Функция rdsVSAddAutoConn добавляет в объект-редактор переменных связь основной переменной (входа или выхода) со вспомогательной (связанным сигналом для входа или управляющей переменной для выхода). Использование вспомогательных переменных в моделях блоков описывается в §2.5.7 и §2.5.8 руководства программиста.

  int RDSCALL rdsVSAddAutoConnA(
    RDS_HOBJECT Vars,     // Редактор переменных
    RDSCSTR MainVarName,  // Основная переменная (UTF8)
    RDSCSTR ConnVarName   // Вспомогательная переменная (UTF8)
  );
  int RDSCALL rdsVSAddAutoConnW(
    RDS_HOBJECT Vars,     // Редактор переменных
    RDSWCSTR MainVarName, // Основная переменная (UTF16)
    RDSWCSTR ConnVarName  // Вспомогательная переменная (UTF16)
  );
  // Функция-псевдоним
  int RDSCALL rdsVSAddAutoConn(
    RDS_HOBJECT Vars,     // Редактор переменных
    RDSXCSTR MainVarName, // Основная переменная (кодировка по умолчанию)
    RDSXCSTR ConnVarName  // Вспомогательная переменная (кодировка по умолчанию)
  );

Тип указателя на эту функцию

RDS_IHoSS (для UTF8) или RDS_IHoWsWs (для UTF16)

Параметры

Vars (RDS_HOBJECT)

Идентификатор вспомогательного объекта-редактора переменных, ранее созданного функцией rdsVSCreateEditor.

MainVarName (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку с именем основной переменной (входа или выхода).

ConnVarName (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку с именем вспомогательной переменной (связанного сигнала для входа или управляющей переменной для выхода).

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

Номер добавленной связи или −1 в случае ошибки (такая связь уже существует).

Примечания

Эта функция позволяет привязать в входу блока сигнальную переменную, которая будет автоматически взводиться при срабатывании связи, подключенной к этому входу, или привязать к выходу блока логическую или целую переменную, разрешающую срабатывание связи, идущей от этого выхода. В параметрах функции указывается имя входа или выхода (MainVarName) и имя связанной переменной (ConnVarName).

См. также

rdsVSCreateEditor, rdsVSApplyToBlock, RDS_HVAR_GETAUTOCONN, RDS_HVAR_GETAUTOCOUNT, RDS_HVAR_GETAUTOMAIN.