Classe CClientDC

  • Artigo

Cuida de chamar as funções do Windows GetDC no momento da construção e ReleaseDC no momento da destruição.

Sintaxe

class CClientDC : public CDC

Membros

Construtores públicos

Nome Descrição
CClientDC::CClientDC Constrói um objeto CClientDC conectado ao CWnd.

Membros de dados protegidos

Nome Descrição
CClientDC::m_hWnd O HWND da janela para a qual esse CClientDC é válido.

Comentários

Isso significa que o contexto do dispositivo associado a um objeto CClientDC é a área de cliente de uma janela.

Para mais informações sobre CClientDC, confira Contextos de dispositivo.

Hierarquia de herança

CObject

CDC

CClientDC

Requisitos

Cabeçalho: afxwin.h

CClientDC::CClientDC

Constrói um objeto CClientDC que acessa a área do cliente do CWnd apontado por pWnd.

explicit CClientDC(CWnd* pWnd);

Parâmetros

pWnd
A janela cuja área do cliente o objeto de contexto do dispositivo acessará.

Comentários

O construtor chama a função do Windows GetDC.

Uma exceção (do tipo CResourceException) será gerada se a chamada GetDC do Windows falhar. Um contexto de dispositivo poderá não estar disponível se o Windows já tiver alocado todos os seus contextos de dispositivo disponíveis. Seu aplicativo compete com pelos cinco contextos de exibição comuns disponíveis a qualquer momento no Windows.

Exemplo

void CDCView::DrawInClientDC(CDC *pDC)
{
   UNREFERENCED_PARAMETER(pDC);
   CClientDC clientDC(this);
   clientDC.TextOut(10, 10, CString(_T("I used a client DC!")));
}

CClientDC::m_hWnd

O HWND do ponteiro CWnd usado para construir o objeto CClientDC.

HWND m_hWnd;

Comentários

m_hWnd é uma variável protegida.

Exemplo

Consulte o exemplo de CClientDC::CClientDC.

Confira também

MDI de exemplo do MFC
Classe CDC
Gráfico da hierarquia
Classe CDC