Функция ExtSelectClipRgn (wingdi.h)
Функция ExtSelectClipRgn объединяет указанную область с текущей областью обрезки в указанном режиме.
Синтаксис
int ExtSelectClipRgn(
[in] HDC hdc,
[in] HRGN hrgn,
[in] int mode
);
Параметры
[in] hdc
Дескриптор контекста устройства.
[in] hrgn
Дескриптор выбранной области. Этот дескриптор не должен иметь значение NULL , если не указан режим RGN_COPY.
[in] mode
Операция, которая выполняется. Это должно быть одно из следующих значений.
Значение | Значение |
---|---|
|
Новая область обрезки объединяет перекрывающиеся области текущей области отсечения и региона, определяемого hrgn. |
|
Новая область обрезки — это копия региона, определяемого hrgn. Это идентично SelectClipRgn. Если регион, определенный hrgn , имеет значение NULL, новая область отсечения является областью обрезки по умолчанию (по умолчанию область отсечения — это область null). |
|
Новый регион обрезки объединяет области текущего отсечения с областями, исключенными из региона, определенного hrgn. |
|
Новая область обрезки объединяет текущую область обрезки и регион, определяемый hrgn. |
|
Новая область обрезки объединяет текущую область обрезки и регион, определяемый hrgn, но исключает перекрывающиеся области. |
Возвращаемое значение
Возвращаемое значение указывает сложность новой области обрезки; Это может быть одно из следующих значений.
Код возврата | Описание |
---|---|
|
Область пуста. |
|
Область представляет собой один прямоугольник. |
|
Область — это несколько прямоугольников. |
|
Произошла ошибка. |
Комментарии
Если при вызове этой функции возникает ошибка, предыдущая область обрезки для указанного контекста устройства не затрагивается.
Функция ExtSelectClipRgn предполагает, что координаты для указанной области указаны в единицах устройства.
Используется только копия области, определяемой параметром hrgn . Сам регион можно повторно использовать после этого вызова или удалить.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | wingdi.h (включая Windows.h) |
Библиотека | Gdi32.lib |
DLL | Gdi32.dll |