Função GetWindowDC (winuser.h)

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

Confira também

Beginpaint

Getdc

GetSystemMetrics

Funções de pintura e desenho

Visão geral de pintura e desenho

Releasedc