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

Статья
08/27/2023

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

Синтаксис

int GetRandomRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn,
  [in] INT  i
);

Параметры

[in] hdc

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

[in] hrgn

Дескриптор области. Перед вызовом функции определяется существующий регион. После возврата функция идентифицирует копию текущей системной области. Старая область, определяемая hrgn , перезаписывается.

[in] i

Этот параметр должен иметь значение SYSRGN.

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

Если функция выполнена успешно, возвращается значение 1. Если функция завершается сбоем, возвращается значение -1. Если извлекаемая область имеет значение NULL, возвращаемое значение равно 0. Если функция завершается сбоем или извлекаемая область имеет значение NULL, hrgn не инициализируется.

При использовании флага SYSRGN обратите внимание, что область обрезки системы может быть не текущей из-за перемещений окон. Тем не менее, при обработке WM_PAINT безопасно извлекать и использовать системную область отсечения в блоке BeginPaint-EndPaint. В этом случае системная область является пересечением области обновления и текущей видимой области окна. Любое перемещение окна после возврата GetRandomRgn и перед EndPaint приведет к созданию нового сообщения WM_PAINT . Любое другое использование флага SYSRGN может привести к ошибкам рисования в приложении.

Возвращаемая область находится в экранных координатах.

Требования

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