Приложения

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

А.4. Структуры RDS

А.4.4. RDS_CONNAPPEARANCE – внешний вид связи или шины

Структура RDS_CONNAPPEARANCE используется для получения и установки внешнего вида связей и шин – их цвета, толщины линий, размеров стрелок и т.п. Координаты точек связи или шины, соединяемые связью переменные и каналы шин в этой структуре не отражаются, для их получения и установки следует использовать структуру RDS_CONNDESCRIPTION и сервисные функции работы со связями.

  typedef struct {
    DWORD servSize;       // Размер этой структуры в байтах
    COLORREF LineColor;   // Цвет
    RDSINT32 LineWidth;   // Толщина линии
    RDSINT32 LineStyle;   // Стиль линии (WinAPI)
    RDSINT32 ArrowLength; // Длина стрелки (0...255)
    RDSINT32 ArrowWidth;  // Выступ стрелки (0...255)
    RDSINT32 DotSize;     // Диаметр точки соединения
  } RDS_CONNAPPEARANCE;
  typedef RDS_CONNAPPEARANCE *RDS_PCONNAPPEARANCE;

Поля структуры

servSize (DWORD)

Размер этой структуры в байтах. Перед вызовом любой сервисной функции, работающей с этой структурой, полю servSize необходимо присвоить значение sizeof(RDS_CONNAPPEARANCE).

LineColor (COLORREF)

Цвет связи.

LineWidth (RDSINT32)

Толщина линии связи в точках экрана в масштабе 100%.

LineStyle (RDSINT32)

PS_DASH	Пунктирная линия.
PS_DASHDOT	Линия из чередующихся отрезков и точек.
PS_DASHDOTDOT	Линия из повторяющихся групп «отрезок-точка-точка».
PS_DOT	Линия, состоящая из точек.
PS_INSIDEFRAME	Специальный стиль сплошной линии, разрешающий Windows скорректировать размеры геометрической фигуры, ограниченной этой линией так, чтобы она уместилась в заданный прямоугольник. В RDS этот стиль не используется для рисования связей и не может быть задан пользователем для связи или шины.
PS_NULL	Невидимая линия (этот стиль не может быть задан пользователем для связи или шины).
PS_SOLID	Сплошная линия.

ArrowLength (RDSINT32)

Длина стрелки на конце связи, соединенном с входом блока, или на конце шины, соединенном с вводом шины. Указывается в точках экрана для масштаба 100%. Принимает значения от 0 (нет стрелки) до 255. Стрелки длиннее 255 точек не поддерживаются.

ArrowWidth (RDSINT32)

Боковой выступ стрелки на конце связи, соединенном с входом блока, или на конце шины, соединенном с вводом шины. Указывается в точках экрана для масштаба 100%. Принимает значения от 0 (нет стрелки) до 255. Стрелки с выступом больше 255 точек (то есть общей шириной более 510 точек) не поддерживаются.

DotSize (RDSINT32)

Размер узла связи, то есть диаметр круга, рисуемого в точках разветвления. Указывается в точках экрана для масштаба 100%. Принимает значения от 0 (нет узла) до 255. Узлы диаметром более 255 точек не поддерживаются.

Пример

Пример работы со структурой RDS_CONNAPPEARANCE приведен в §2.13.4 руководства программиста.

См. также

rdsGetConnAppearance, rdsSetConnAppearance, rdsGetConnStyleAppearance, rdsAltConnAppearanceOp, RDS_CONNDESCRIPTION.