Функция ExtSelectClipRgn (wingdi.h)

Функция ExtSelectClipRgn объединяет указанную область с текущей областью обрезки в указанном режиме.

Синтаксис

int ExtSelectClipRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn,
  [in] int  mode
);

Параметры

[in] hdc

Дескриптор контекста устройства.

[in] hrgn

Дескриптор выбранной области. Этот дескриптор не должен иметь значение NULL , если не указан режим RGN_COPY.

[in] mode

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

Значение Значение
RGN_AND
Новая область обрезки объединяет перекрывающиеся области текущей области отсечения и региона, определяемого hrgn.
RGN_COPY
Новая область обрезки — это копия региона, определяемого hrgn. Это идентично SelectClipRgn. Если регион, определенный hrgn , имеет значение NULL, новая область отсечения является областью обрезки по умолчанию (по умолчанию область отсечения — это область null).
RGN_DIFF
Новый регион обрезки объединяет области текущего отсечения с областями, исключенными из региона, определенного hrgn.
RGN_OR
Новая область обрезки объединяет текущую область обрезки и регион, определяемый hrgn.
RGN_XOR
Новая область обрезки объединяет текущую область обрезки и регион, определяемый hrgn, но исключает перекрывающиеся области.

Возвращаемое значение

Возвращаемое значение указывает сложность новой области обрезки; Это может быть одно из следующих значений.

Код возврата Описание
NULLREGION
Область пуста.
SIMPLEREGION
Область представляет собой один прямоугольник.
COMPLEXREGION
Область — это несколько прямоугольников.
ошибка
Произошла ошибка.

Комментарии

Если при вызове этой функции возникает ошибка, предыдущая область обрезки для указанного контекста устройства не затрагивается.

Функция ExtSelectClipRgn предполагает, что координаты для указанной области указаны в единицах устройства.

Используется только копия области, определяемой параметром hrgn . Сам регион можно повторно использовать после этого вызова или удалить.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wingdi.h (включая Windows.h)
Библиотека Gdi32.lib
DLL Gdi32.dll

См. также раздел

Функции обрезки

Общие сведения об обрезки

SelectClipRgn