Clase CPaintDC

  • Artículo

Una clase de contexto de dispositivo derivada de CDC.

Sintaxis

class CPaintDC : public CDC

Miembros

Constructores públicos

Nombre Descripción
CPaintDC::CPaintDC Construye un CPaintDC conectado al CWnd especificado.

Miembros de datos públicos

Nombre Descripción
CPaintDC::m_ps Contiene el PAINTSTRUCT utilizado para pintar el área cliente.

Miembros de datos protegidos

Nombre Descripción
CPaintDC::m_hWnd El HWND al cual se adjunta este objeto CPaintDC.

Comentarios

Realiza un CWnd::BeginPaint en tiempo de construcción y CWnd::EndPaint en tiempo de destrucción.

Un objeto CPaintDC solo se puede usar al responder a un mensaje WM_PAINT, normalmente en la función miembro del controlador de mensajes de OnPaint.

Para obtener más información sobre cómo usar CPaintDC, consulte Contextos de dispositivo.

Jerarquía de herencia

CObject

CDC

CPaintDC

Requisitos

Encabezadoafxwin.h:

CPaintDC::CPaintDC

Construye un objeto CPaintDC, prepara la ventana de la aplicación para pintar y almacena la estructura PAINTSTRUCT en la variable miembro m_ps.

explicit CPaintDC(CWnd* pWnd);

Parámetros

pWnd
Apunta al objeto CWnd al que pertenece el objeto CPaintDC.

Comentarios

Se genera una excepción (de tipo CResourceException) si se produce un error en la llamada a GetDC de Windows. Es posible que un contexto de dispositivo no esté disponible si Windows ya ha asignado todos sus contextos de dispositivo disponibles. La aplicación compite por los cinco contextos de visualización comunes disponibles en cualquier momento en Windows.

Ejemplo

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

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

CPaintDC::m_hWnd

El HWND al cual se adjunta este objeto CPaintDC.

HWND m_hWnd;

Comentarios

m_hWnd es una variable protegida de tipo HWND.

Ejemplo

// 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 es una variable miembro pública de tipo PAINTSTRUCT.

PAINTSTRUCT m_ps;

Comentarios

Es el PAINTSTRUCT que se pasa a y se rellena mediante CWnd::BeginPaint.

El PAINTSTRUCT contiene información que la aplicación usa para pintar el área cliente de la ventana asociada a un objeto CPaintDC.

Tenga en cuenta que puede acceder al manipulador de contexto del dispositivo a través de PAINTSTRUCT. Sin embargo, puede acceder al manipulador más directamente a través de la variable miembro m_hDC que CPaintDC hereda de CDC.

Ejemplo

Vea el ejemplo de CPaintDC::m_hWnd.

Consulte también

Ejemplo MDI de MFC
CDC (clase)
Gráfico de jerarquías