Приложения

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

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

А.5.23. Вспомогательный объект для изменения связей и шин

А.5.23.4. rdsCEAddBusPoint – добавление точки соединения с шиной

Функция rdsCEAddBusPoint добавляет в объект редактирования связи новую точку соединения с шиной.

  int RDSCALL rdsCEAddBusPointA(
    RDS_HOBJECT Editor, // Объект
    RDS_CHANDLE Bus,    // Шина
    RDSCSTR VarName,    // Имя переменной канала (UTF8)
    BOOL Output,        // Источник данных
    int x,int y,        // Координаты точки
    BOOL DisplayName    // Отображать имя переменной
  );
  int RDSCALL rdsCEAddBusPointW(
    RDS_HOBJECT Editor, // Объект
    RDS_CHANDLE Bus,    // Шина
    RDSWCSTR VarName,   // Имя переменной канала (UTF16)
    BOOL Output,        // Источник данных
    int x,int y,        // Координаты точки
    BOOL DisplayName    // Отображать имя переменной
  );
  // Функция-псевдоним
  int RDSCALL rdsCEAddBusPoint(
    RDS_HOBJECT Editor, // Объект
    RDS_CHANDLE Bus,    // Шина
    RDSXCSTR VarName,   // Имя переменной канала (кодировка по умолчанию)
    BOOL Output,        // Источник данных
    int x,int y,        // Координаты точки
    BOOL DisplayName    // Отображать имя переменной
  );

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

RDS_IHoChSBIIB (для UTF8) или RDS_IHoChWsBIIB (для UTF16)

Параметры

Editor (RDS_HOBJECT): Идентификатор вспомогательного объекта для редактирования связи, ранее созданного функцией rdsCECreateEditor.
Bus (RDS_CHANDLE): Идентификатор шины, точка соединения с которой добавляется.
VarName (RDSCSTR, RDSWCSTR, RDSXCSTR): Указатель на строку с именем канала шины Bus, с которым соединяется добавляемая точка связи. Для связей, соединяемых с выходом канала, в имя могут входить поля структур и элементы массивов и матриц, например, «compl.Re» или «M1[2][4]».
Output (BOOL): TRUE – точка подключает связь к выходу канала шины (канал будет источником данных для данной связи), FALSE – точка подключает связь ко входу канала (канал будет получателем данных).
x, y (int): Горизонтальная (x) и вертикальная (y) координаты точки на рабочем поле. Координаты указываются в точках экрана в масштабе 100%.
DisplayName (BOOL): TRUE – отображать имя переменной канала рядом с точкой связи, FALSE – не отображать.

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

Номер добавленной точки или −1 в случае ошибки (если Editor – объект не того типа). Эти номера точек используются в функциях создания отрезков связи rdsCEAddLine и rdsCEAddBezier.

Примечания

Эта функция добавляет во внутренний набор объекта новую точку связи, которая будет соединять ее с каналом VarName шины Bus. Параметр Output определяет, будет эта точка получать данные из канала (TRUE) или записывать их в канал (FALSE). При Output==FALSE, когда связь передает данные в шину, в параметре VarName может передаваться только имя канала. При Output==TRUE, когда связь забирает данные из шины, в параметре VarName может также указываться имя внутреннего элемента сложной переменной канала (например, поле структуры или элемент матрицы).

См. также

rdsCECreateEditor, rdsCEAddLine, rdsCEAddBezier, rdsCEAddInternalPoint, rdsCEAddBlockPoint, RDS_POINTDESCRIPTION.