Функция GetRegionData (wingdi.h)
Функция GetRegionData заполняет указанный буфер данными, описывающими область. Эти данные включают размеры прямоугольников, составляющих область.
Синтаксис
DWORD GetRegionData(
[in] HRGN hrgn,
[in] DWORD nCount,
[out] LPRGNDATA lpRgnData
);
Параметры
[in] hrgn
Дескриптор региона.
[in] nCount
Размер буфера lpRgnData в байтах.
[out] lpRgnData
Указатель на структуру RGNDATA , которая получает сведения. Измерения области находятся в логических единицах. Если этот параметр имеет значение NULL, возвращаемое значение содержит количество байтов, необходимое для данных региона.
Возвращаемое значение
Если функция выполняется успешно и nCount задает достаточное количество байтов, то возвращаемое значение равно фактическому количеству используемых байтов (меньше или равно nCount).
Если lpRgnData имеет значение NULL, то возвращаемое значение — необходимое количество байтов.
Если функция завершается сбоем, возвращаемое значение равно нулю.
Если ошибка вызвана недопустимой ошибкой hrgn , метод GetLastError возвращает ERROR_INVALID_HANDLE. В противном случае GetLastError возвращает ERROR_INVALID_PARAMETER .
Если nCount слишком мал, функция завершается ошибкой.
Комментарии
Функция GetRegionData используется в сочетании с функцией ExtCreateRegion .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wingdi.h (включая Windows.h) |
| Библиотека | Gdi32.lib |
| DLL | Gdi32.dll |