Função GetRegionData (wingdi.h)
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 |