Função GetWindowDC (winuser.h)

Artigo
03/04/2024

A função GetWindowDC recupera o contexto do dispositivo (DC) para toda a janela, incluindo barra de título, menus e barras de rolagem. Um contexto de dispositivo de janela permite a pintura em qualquer lugar em uma janela, pois a origem do contexto do dispositivo é o canto superior esquerdo da janela em vez da área do cliente.

GetWindowDC atribui atributos padrão ao contexto do dispositivo de janela sempre que recupera o contexto do dispositivo. Atributos anteriores são perdidos.

Sintaxe

HDC GetWindowDC(
  [in] HWND hWnd
);

Parâmetros

[in] hWnd

Um identificador para a janela com um contexto de dispositivo que deve ser recuperado. Se esse valor for NULL, GetWindowDC recuperará o contexto do dispositivo para toda a tela.

Se esse parâmetro for NULL, GetWindowDC recuperará o contexto do dispositivo para o monitor de exibição primário. Para obter o contexto do dispositivo para outros monitores de exibição, use as funções EnumDisplayMonitors e CreateDC .

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador para um contexto de dispositivo para a janela especificada.

Se a função falhar, o valor retornado será NULL, indicando um erro ou um parâmetro hWnd inválido.

Comentários

GetWindowDC destina-se a efeitos especiais de pintura dentro da área não cliente de uma janela. Não é recomendável pintar em áreas não comuns de qualquer janela.

A função GetSystemMetrics pode ser usada para recuperar as dimensões de várias partes da área não cliente, como a barra de título, o menu e as barras de rolagem.

A função GetDC pode ser usada para recuperar um contexto de dispositivo para toda a tela.

Após a conclusão da pintura, a função ReleaseDC deve ser chamada para liberar o contexto do dispositivo. Não liberar o contexto do dispositivo de janela tem efeitos sérios na pintura solicitada pelos aplicativos.

Requisitos

Requisito	Valor
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 em Windows 8)