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 |