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

Описания RDS

Приложения

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

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

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

А.5.23.3. rdsCEAddBlockPoint – добавление точки соединения с блоком

# Приложения

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

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

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

##### А.5.23.3. rdsCEAddBlockPoint – добавление точки соединения с блоком

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

      int RDSCALL rdsCEAddBlockPointA(
        RDS_HOBJECT Editor, // Объект
        RDS_BHANDLE Block,  // Блок
        RDSCSTR VarName,    // Имя переменной блока (UTF8)
        int x,int y,        // Относительные координаты точки
        BOOL DisplayName    // Отображать имя переменной
      );
      int RDSCALL rdsCEAddBlockPointW(
        RDS_HOBJECT Editor, // Объект
        RDS_BHANDLE Block,  // Блок
        RDSWCSTR VarName,   // Имя переменной блока (UTF16)
        int x,int y,        // Относительные координаты точки
        BOOL DisplayName    // Отображать имя переменной
      );
      // Функция-псевдоним
      int RDSCALL rdsCEAddBlockPoint(
        RDS_HOBJECT Editor, // Объект
        RDS_BHANDLE Block,  // Блок
        RDSXCSTR VarName,   // Имя переменной блока (кодировка по умолчанию)
        int x,int y,        // Относительные координаты точки
        BOOL DisplayName    // Отображать имя переменной
      );

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

RDS_IHoBhSIIB (для UTF8) или RDS_IHoBhWsIIB (для UTF16)

Параметры

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

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

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

Примечания

Эта функция добавляет во внутренний набор объекта новую точку связи, которая будет соединять ее с переменной VarName блока Block. Координаты точки указываются относительно точки привязки блока.

Пример

Пример использования функции rdsCEAddBlockPoint приведен в §2.16.2 руководства программиста.

См. также

rdsCECreateEditor, rdsCEAddLine, rdsCEAddBezier, rdsCEAddInternalPoint, rdsCEAddBusPoint, RDS_POINTDESCRIPTION.