Classe CPaintDC

  • Artigo

Uma classe de contexto de dispositivo derivada de CDC.

Sintaxe

class CPaintDC : public CDC

Membros

Construtores públicos

Nome Descrição
CPaintDC::CPaintDC Constrói uma conexão CPaintDC com o CWnd especificado.

Membros de Dados Públicos

Nome Descrição
CPaintDC::m_ps Contém o PAINTSTRUCT usado para pintar a área de cliente.

Membros de dados protegidos

Nome Descrição
CPaintDC::m_hWnd O HWND a qual o objeto CPaintDC é anexado.

Comentários

Ele executa um CWnd::BeginPaint em tempo de construção e CWnd::EndPaint em tempo de destruição.

Um objeto CPaintDC só pode ser usado ao responder a uma mensagem WM_PAINT, geralmente em sua função de membro do manipulador de mensagens OnPaint.

Para mais informações sobre como usar CPaintDC, confira Contextos do dispositivo.

Hierarquia de herança

CObject

CDC

CPaintDC

Requisitos

Cabeçalho: afxwin.h

CPaintDC::CPaintDC

Constrói um objeto CPaintDC, prepara a janela do aplicativo para pintura e armazena a estrutura PAINTSTRUCT na variável de membro m_ps.

explicit CPaintDC(CWnd* pWnd);

Parâmetros

pWnd
Aponta para o objeto CWnd ao qual o objeto CPaintDC pertence.

Comentários

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

// Get a dc for a CWnd pointer.
CPaintDC dc(pWnd);

// Get a dc for a HWND.
CPaintDC dc2(CWnd::FromHandle(hWnd));

CPaintDC::m_hWnd

O HWND a qual o objeto CPaintDC é anexado.

HWND m_hWnd;

Comentários

m_hWnd é uma variável protegida do tipo HWND.

Exemplo

// Get a dc for a CWnd object pointer.
CPaintDC dc(pWnd);

// Send my private message.
::SendMessage(pWnd->m_hWnd, WM_MYMESSAGE, (LPARAM)& dc.m_ps, 0);

CPaintDC::m_ps

m_ps é uma variável de membro público do tipo PAINTSTRUCT.

PAINTSTRUCT m_ps;

Comentários

É o PAINTSTRUCT que é passado para e preenchido por CWnd::BeginPaint.

O PAINTSTRUCT contém informações que o aplicativo usa para pintar a área de cliente da janela associada a um objeto CPaintDC.

Observe que você pode acessar o identificador de contexto do dispositivo por meio do PAINTSTRUCT. No entanto, você pode acessar o identificador mais diretamente por meio da variável de membro m_hDC que CPaintDC herda do CDC.

Exemplo

Confira o exemplo de CPaintDC::m_hWnd.

Confira também

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