Função GetRegionData (wingdi.h)

Artigo
03/04/2024

A função GetRegionData preenche o buffer especificado com dados que descrevem uma região. Esses dados incluem as dimensões dos retângulos que compõem a região.

Sintaxe

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

Parâmetros

[in] hrgn

Um identificador para a região.

[in] nCount

O tamanho, em bytes, do buffer lpRgnData .

[out] lpRgnData

Um ponteiro para uma estrutura RGNDATA que recebe as informações. As dimensões da região estão em unidades lógicas. Se esse parâmetro for NULL, o valor retornado conterá o número de bytes necessários para os dados da região.

Retornar valor

Se a função for bem-sucedida e nCount especificar um número adequado de bytes, o valor retornado será igual ao número real de bytes usados (menor ou igual a nCount).

Se lpRgnData for NULL, o valor retornado será o número necessário de bytes.

Se a função falhar, o valor retornado será zero.

Se a falha for devido a hrgn ser inválido, GetLastError retornará ERROR_INVALID_HANDLE. Caso contrário, GetLastError retornará ERROR_INVALID_PARAMETER .

Se nCount for muito pequeno, a função falhará.

Comentários

A função GetRegionData é usada em conjunto com a função ExtCreateRegion .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll