Partilhar via


CDC::DeleteDC

Em geral, não chamar essa função; o destrutor fá-la-á para você.

BOOL DeleteDC( );

Valor de retorno

Diferente de zero se a função terminou com êxito; se não 0.

Comentários

A função de membro de DeleteDC exclui os contextos de dispositivo do windows que estão associados com m_hDC no objeto atual de CDC .Se este objeto de CDC é o contexto ativa o último de dispositivo para um determinado dispositivo, o dispositivo for notificado e todos os recursos de armazenamento e do sistema usados pelo dispositivo são liberados.

Um aplicativo não deve chamar DeleteDC se os objetos foram selecionados no contexto de dispositivo.Os objetos devem primeiro ser selecionados fora do contexto de dispositivo antes que seja excluído.

Um aplicativo não deve excluir um contexto de dispositivo cuja identificador é obtida chamando CWnd::GetDC.Em vez de isso, deve chamar CWnd::ReleaseDC para liberar o contexto de dispositivo.As classes de CClientDC e de CWindowDC são fornecidas para envolver essa funcionalidade.

A função de DeleteDC é geralmente usada para excluir os contextos de dispositivo criados com CreateDC, CreateIC, ou CreateCompatibleDC.

Exemplo

Consulte o exemplo para CPrintDialog::GetPrinterDC.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CDC Class

Gráfico de hierarquia

CDC::CDC

DeleteDC

CDC::CreateDC

CDC::CreateIC

CDC::CreateCompatibleDC

CWnd::GetDC

CWnd::ReleaseDC