Share via


CDC::DeleteDC

No llame a normalmente esta función; destructor la hará automáticamente.

BOOL DeleteDC( );

Valor devuelto

Distinto de cero si la función se completó correctamente; si no 0.

Comentarios

La función miembro de DeleteDC elimina los contextos de dispositivo de Windows que están asociados con m_hDC en el objeto actual de CDC .Si este objeto de CDC es el contexto activo el último dispositivo para un dispositivo dado, se notifica al dispositivo y liberan todo el almacenamiento y recursos del sistema utilizados por el dispositivo.

Una aplicación no debe llamar a DeleteDC si los objetos se han seleccionado en el contexto del dispositivo.Los objetos primero deben seleccionarse fuera del contexto de dispositivo antes de que se elimine.

Una aplicación no debe eliminar un contexto de dispositivo cuyo identificador se obtenidos llamando a CWnd:: GetDC.En su lugar, debe llamar a CWnd:: ReleaseDC para liberar el contexto del dispositivo.las clases de CClientDC y de CWindowDC se proporcionan para ajustar esta funcionalidad.

La función de DeleteDC se utiliza normalmente para eliminar los contextos de dispositivo creados con CreateDC, CreateIC, o CreateCompatibleDC.

Ejemplo

Vea el ejemplo para CPrintDialog:: GetPrinterDC.

Requisitos

encabezado: afxwin.h

Vea también

Referencia

Clase de la CDC

Gráfico de jerarquía

CDC::CDC

DeleteDC

CDC::CreateDC

CDC::CreateIC

CDC::CreateCompatibleDC

CWnd::GetDC

CWnd::ReleaseDC