Função SetWindowRgn (winuser.h)

  • Artigo

A função SetWindowRgn define a região da janela de uma janela. 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 SetWindowRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn,
  [in] BOOL bRedraw
);

Parâmetros

[in] hWnd

Um identificador para a janela cuja região da janela deve ser definida.

[in] hRgn

Um identificador para uma região. A função define a região da janela para essa região.

Se hRgn for NULL, a função definirá a região da janela como NULL.

[in] bRedraw

Especifica se o sistema redesenha a janela depois de definir a região da janela. Se bRedraw for TRUE, o sistema o fará; caso contrário, não.

Normalmente, você define bRedraw como TRUE se a janela estiver visível.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

Quando essa função é chamada, o sistema envia as mensagens WM_WINDOWPOSCHANGING e WM_WINDOWPOSCHANGED para a 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.

Nota Se o layout da janela for RTL (da direita para a esquerda), as coordenadas serão relativas ao canto superior direito da janela. Consulte Layout e espelhamento de janela.
 
Após uma chamada bem-sucedida para SetWindowRgn, o sistema possui a região especificada pelo identificador de região hRgn. O sistema não faz uma cópia da região. Portanto, você não deve fazer mais chamadas de função com esse identificador de região. Em particular, não exclua esse identificador de região. O sistema exclui o identificador de região quando ele não é mais necessário.

Para obter a região da janela de uma janela, chame a função GetWindowRgn .

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-0 (introduzido no Windows 8)

Confira também

GetWindowRgn

Funções de pintura e desenho

Visão geral de pintura e desenho

WM_WINDOWPOSCHANGING

WM_WINDOWPOSCHANGED