DeleteObject-Funktion (wingdi.h)

Die DeleteObject-Funktion löscht einen logischen Stift, Pinsel, eine Schriftart, eine Bitmap, eine Region oder eine Palette, wodurch alle dem Objekt zugeordneten Systemressourcen freigegeben werden. Nachdem das Objekt gelöscht wurde, ist das angegebene Handle nicht mehr gültig.

Syntax

BOOL DeleteObject(
  [in] HGDIOBJ ho
);

Parameter

[in] ho

Ein Handle für einen logischen Stift, Pinsel, Eine Schriftart, eine Bitmap, eine Region oder eine Palette.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn das angegebene Handle ungültig ist oder derzeit in einem DC ausgewählt ist, ist der Rückgabewert 0.

Hinweise

Löschen Sie kein Zeichnungsobjekt (Stift oder Pinsel), während es noch in einem DC ausgewählt ist.

Wenn ein Musterpinsel gelöscht wird, wird die dem Pinsel zugeordnete Bitmap nicht gelöscht. Die Bitmap muss unabhängig voneinander gelöscht werden.

Beispiele

Ein Beispiel finden Sie unter Erstellen farbiger Stifte und Pinsel.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll

Weitere Informationen

Gerätekontextfunktionen

Übersicht über Gerätekontexte

Auswählenobjekt