Текущий раздел:

Описания RDS

Приложения

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

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

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

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

# Приложения

## Приложение А. Функции, константы и структуры 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.