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

Статья
08/27/2023

Функция 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

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

BeginPaint

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

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

SelectClipRgn

Поделиться через