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 |
|---|---|
|
A região está vazia. |
|
A região é um único retângulo. |
|
A região é maior do que um retângulo. |
|
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) |