Приложения

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

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

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

А.5.19.21. rdsXGSetClipRect – установить область отсечения

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

  void RDSCALL rdsXGSetClipRect(
    RECT *pRect    // Описание области или NULL
  );

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

RDS_VpR

Параметр

pRect (RECT*)

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

Примечания

Эта функция устанавливает координаты прямоугольной области, за пределами которой не будет производиться рисование. У всех геометрических фигур будут рисоваться только те части, которые попадают внутрь области. Если в параметре pRect передать не указатель на структуру, описывающую область, а NULL, отсечение будет отменено. Область отсечения может, например, использоваться при построении графиков, чтобы линия графика не выходила за пределы координатной сетки.

Если область отсечения должна иметь форму, отличную от прямоугольника, следует использовать соответствующие функции Windows API.

Пример

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