Freigeben über


CDC::DeleteDC

Im Allgemeinen rufen Sie diese Funktion nicht auf; der Destruktor wird nicht für Sie.

BOOL DeleteDC( );

Rückgabewert

Ungleich 0 (null), wenn die Funktion erfolgreich abgeschlossen wurde; 0 andernfalls.

Hinweise

Die DeleteDC-Memberfunktion löscht die Windows-Gerätekontexte, die mit m_hDC im aktuellen CDC-Objekt zugeordnet werden. Wenn dieses CDC-Objekt der letzte aktive Gerätekontext für ein bestimmtes Gerät ist, wird das Gerät benachrichtigt und aller Speicher und Systemressourcen, die durch das Gerät verwendet werden, werden freigegeben.

Eine Anwendung sollte DeleteDC nicht aufrufen, wenn Objekte in den Gerätekontext ausgewählt wurden. Objekte müssen aus dem Gerätekontext out zuerst aktiviert werden, bevor er gelöscht wird.

Eine Anwendung darf keinen Gerätekontext nicht löschen, dessen Handle abgerufen wurde, indem Sie CWnd::GetDC aufgerufen wurde. Stattdessen muss es CWnd::ReleaseDC aufrufen, um den Gerätekontext freizugeben. Die CClientDC und CWindowDC-Klassen werden bereitgestellt, um diese Funktionalität zu umschließen.

Die DeleteDC-Funktion wird im Allgemeinen verwendet, um die Gerätekontexte zu löschen, die mit CreateDC, CreateIC oder CreateCompatibleDC erstellt werden.

Beispiel

Im Beispiel für CPrintDialog::GetPrinterDC.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CDC-Klasse

Hierarchiediagramm

CDC::CDC

DeleteDC

CDC::CreateDC

CDC::CreateIC

CDC::CreateCompatibleDC

CWnd::GetDC

CWnd::ReleaseDC