Приложения

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