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

Описания RDS

Приложения

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

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

А.4.3. RDS_BLOCKDIMENSIONS – размеры и положение блока или связи

# Приложения

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

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

#### А.4.3. RDS_BLOCKDIMENSIONS – размеры и положение блока или связи

Структура RDS_BLOCKDIMENSIONS используется для получения координат и размеров описывающего прямоугольника блока или связи. Положение и размеры блока можно получить при помощи функций rdsGetBlockDimensions и rdsGetBlockDimensionsEx, описывающий прямоугольник связи – при помощи функции rdsGetConnDimensions. В параметрах этих функций можно указать, нужно ли при вычислении размеров учитывать текущий масштаб подсистемы и значения переменных блока, если они влияют на его размеры и координаты.

      typedef struct {
        DWORD servSize;         // Размер этой структуры в байтах
        RDSINT32 BlockX,BlockY; // Положение точки привязки
        RDSINT32 Left,Top;      // Верхний левый угол прямоугольника блока
        RDSINT32 Width,Height;  // Размеры прямоугольника блока
      } RDS_BLOCKDIMENSIONS;
      typedef RDS_BLOCKDIMENSIONS *RDS_PBLOCKDIMENSIONS;

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

servSize(DWORD)
  Размер этой структуры в байтах. Перед вызовом любой сервисной функции, работающей с этой структурой, полю servSize необходимо присвоить значение sizeof(RDS_BLOCKDIMENSIONS).
BlockX, BlockY(RDSINT32)
  Горизонтальная (BlockX) и вертикальная (BlockY) координаты точки привязки изображения блока на рабочем поле подсистемы. Для блоков, изображаемых векторной картинкой, точкой привязки является начало координат этой картинки, для блоков, изображаемых программно или прямоугольником с текстом – левый верхний угол описывающего прямоугольника блока. Горизонтальная ось координат направлена вправо, вертикальная – вниз, начало координат – левый верхний угол рабочего поля.
Left, Top(RDSINT32)
  Горизонтальная (Left) и вертикальная (Top) координаты описывающего прямоугольника блока, то есть прямоугольника минимального размера с горизонтальными и вертикальными сторонами, который целиком покрывает изображение блока. Ни одна точка изображения блока не находится левее координаты Left и выше координаты Top.
Width, Height(RDSINT32)
  Ширина (Width) и высота (Height) описывающего прямоугольника блока. Ни одна точка изображения блока не находится правее координаты (Left+Width) и ниже координаты (Top+Height).

Пример

Примеры использования этой структуры приведены в §2.13.4 и §2.16.2 руководства программиста.

См. также

rdsGetBlockDimensions, rdsGetBlockDimensionsEx, rdsGetConnDimensions.