Função GetWindowRgnBox (winuser.h)
A função GetWindowRgnBox recupera as dimensões do retângulo delimitador mais apertado para a região da janela de uma janela.
Sintaxe
int GetWindowRgnBox(
[in] HWND hWnd,
[out] LPRECT lprc
);
Parâmetros
[in] hWnd
Identificador da janela.
[out] lprc
Ponteiro para uma estrutura RECT que recebe as dimensões do retângulo, em unidades de dispositivo relativas ao canto superior esquerdo da janela.
Retornar valor
O valor retornado especifica o tipo da região que a função obtém. Pode ser um dos seguintes valores.
| Valor | Significado |
|---|---|
| COMPLEXREGION | A região é maior do que um retângulo. |
| ERROR | A janela especificada não tem uma região ou ocorreu um erro ao tentar retornar a região. |
| NULLREGION | A região está vazia. |
| SIMPLEREGION | A região é um único retângulo. |
Comentários
A região da janela determina a área dentro da janela em que o sistema permite o desenho. O sistema não exibe nenhuma parte de uma janela que esteja fora da região da janela. As coordenadas da região da janela de uma janela são relativas ao canto superior esquerdo da janela, não à área do cliente da janela.
Para definir a região da janela de uma janela, chame a função SetWindowRgn .
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 | winuser.h (inclua Windows.h) |
| Biblioteca | User32.lib |
| DLL | User32.dll |
| Conjunto de APIs | ext-ms-win-ntuser-draw-l1-1-0 (introduzido no Windows 8) |