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


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

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

CreatePolyPolygonRgn

CreatePolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateRoundRectRgn

ExtCreateRegion

RGNDATA

Функции регионов

Обзор регионов