Função GetWindowRgn (winuser.h)

A função GetWindowRgn obtém uma cópia da região da janela de uma janela. A região da janela de uma janela é definida chamando a função SetWindowRgn . 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

Sintaxe

int GetWindowRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn
);

Parâmetros

[in] hWnd

Manipule para a janela cuja região da janela deve ser obtida.

[in] hRgn

Manipule para a região que será modificada para representar a região da janela.

Valor retornado

O valor retornado especifica o tipo da região que a função obtém. Pode ser um dos seguintes valores.

Código de retorno Descrição
NULLREGION
A região está vazia.
SIMPLEREGION
A região é um único retângulo.
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.

Comentários

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 .

Exemplos

O código a seguir mostra como você passa o identificador de uma região existente.


HRGN hrgn = CreateRectRgn(0,0,0,0);
int regionType = GetWindowRgn(hwnd, hrgn);
if (regionType != ERROR) 
{ 
/* hrgn contains window region */ 
}
DeleteObject(hrgn); /* finished with region */

Requisitos

   
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-2 (introduzido no Windows 10, versão 10.0.10240)

Confira também

Funções de pintura e desenho

Visão geral de pintura e desenho

Setwindowrgn