Compartilhar via


CWnd::GetWindowDC

Recupera o contexto de exibição para a janela inteira, incluindo a barra de título, os menus, e as barras de rolagem.

CDC* GetWindowDC( );

Valor de retorno

Identifica o contexto de exibição para a janela se a função é fornecida com êxito; se não NULO.

O ponteiro retornado pode ser temporário e não deve ser armazenado para uso posterior. ReleaseDC deve ser chamado uma vez para cada chamada com êxito a GetWindowDC.

Comentários

Um contexto de exibição da janela permite pintar em qualquer lugar em CWnd, como a origem de contexto é o canto superior esquerdo de CWnd em vez da área cliente.

Os atributos padrões são atribuídos ao contexto de exibição cada vez que recupera o contexto. Os atributos anteriores são perdidos.

GetWindowDC destina-se a ser usado para efeitos especiais de pintura dentro da área de nonclient de CWnd . A pintura em áreas de nonclient de qualquer janela não é recomendada.

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

Depois que a pintura é concluída, a função de membro de ReleaseDC deve ser chamada para liberar o contexto de exibição. A falha ao contexto de exibição afetará seriamente a pintura solicitada por aplicativos devido às restrições no número de contextos de dispositivo que podem estar abertos ao mesmo tempo.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CWnd Class

Gráfico da hierarquia

GetSystemMetrics

CWnd::ReleaseDC

GetWindowDC

CWnd::GetDC

Classe CWindowDC