Приложения

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

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

А.5.19. Графические функции

А.5.19.11. rdsXGGetVisibleRect – получить координаты видимой области

Функция rdsXGGetVisibleRect возвращает координаты прямоугольной области рисования, видимой в данный момент, если модель блока вызвана для рисования.

  void RDSCALL rdsXGGetVisibleRect(
    RECT *pRect    // Заполняемая структура координат
  );

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

RDS_VpR

Параметр

pRect (RECT*)

Указатель на структуру описания прямоугольника RECT Windows API, в которую функция записывает координаты видимой области.

Примечания

Эта функция возвращает координаты прямоугольной области, за пределами которой можно ничего не рисовать. При рисовании внешнего вида блока эта область соответствует видимой в окне части рабочего поля, при рисовании на панелях модальных окон – размерам панели и т.п. Модели блока не обязательно программно отсекать изображения за пределами этой области, это выполняется автоматически. Чаше всего функция rdsXGGetVisibleRect используется в моделях блоков, занимающих большую площадь на рабочем поле и строящих сложные изображения (например, географические карты). Проверка на попадание элементов изображения блока в видимую область и пропуск рисования не попавших в нее позволяет существенно ускорить рисование, особенно при крупных масштабах окна подсистемы.