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