Função GetUpdateRgn (winuser.h)

  • Artigo

A função GetUpdateRgn recupera a região de atualização de uma janela copiando-a para a região especificada. As coordenadas da região de atualização são relativas ao canto superior esquerdo da janela (ou seja, são coordenadas do cliente).

Sintaxe

int GetUpdateRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn,
  [in] BOOL bErase
);

Parâmetros

[in] hWnd

Manipule para a janela com uma região de atualização que deve ser recuperada.

[in] hRgn

Manipule para a região para receber a região de atualização.

[in] bErase

Especifica se a tela de fundo da janela deve ser apagada e se áreas não cliente de janelas filho devem ser desenhadas. Se esse parâmetro for FALSE, nenhum desenho será feito.

Valor retornado

O valor retornado indica a complexidade da região resultante; pode ser um dos valores a seguir.

Valor Significado
COMPLEXREGION A região consiste em mais de um retângulo.
ERROR Ocorreu um erro.
NULLREGION A região está vazia.
SIMPLEREGION A região é um único retângulo.

Comentários

A função BeginPaint valida automaticamente a região de atualização, portanto, qualquer chamada para GetUpdateRgn feita imediatamente após a chamada para BeginPaint recupera uma região de atualização vazia.

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

Funções de pintura e desenho

Visão geral de pintura e desenho