Função GetWindowRgnBox (winuser.h)

Artigo
03/04/2024

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)