Compartir a través de


Función GetRegionData (wingdi.h)

La función GetRegionData rellena el búfer especificado con datos que describen una región. Estos datos incluyen las dimensiones de los rectángulos que componen la región.

Sintaxis

DWORD GetRegionData(
  [in]  HRGN      hrgn,
  [in]  DWORD     nCount,
  [out] LPRGNDATA lpRgnData
);

Parámetros

[in] hrgn

Identificador de la región.

[in] nCount

Tamaño, en bytes, del búfer lpRgnData .

[out] lpRgnData

Puntero a una estructura RGNDATA que recibe la información. Las dimensiones de la región están en unidades lógicas. Si este parámetro es NULL, el valor devuelto contiene el número de bytes necesarios para los datos de la región.

Valor devuelto

Si la función se ejecuta correctamente y nCount especifica un número adecuado de bytes, el valor devuelto es igual al número real de bytes usados (menor o igual que nCount).

Si lpRgnData es NULL, el valor devuelto es el número necesario de bytes.

Si se produce un error en la función, el valor devuelto es cero.

Si el error se debe a que hrgn no es válido, GetLastError devuelve ERROR_INVALID_HANDLE. De lo contrario, GetLastError devuelve ERROR_INVALID_PARAMETER .

Si nCount es demasiado pequeño, se produce un error en la función.

Comentarios

La función GetRegionData se usa junto con la función ExtCreateRegion .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wingdi.h (incluye Windows.h)
Library Gdi32.lib
Archivo DLL Gdi32.dll

Consulte también

CreatePolyPolygonRgn

CreatePolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateRoundRectRgn

ExtCreateRegion

RGNDATA

Funciones de región

Información general sobre regiones