Função GetUpdateRgn (winuser.h)
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) |