UnrealizeObject-Funktion (wingdi.h)

Die Funktion UnrealizeObject setzt den Ursprung eines Pinsels zurück oder setzt eine logische Palette zurück. Wenn der hgdiobj-Parameter ein Handle für einen Pinsel ist, weist UnrealizeObject das System an, den Ursprung des Pinsels zurückzusetzen, wenn er das nächste Mal ausgewählt wird. Wenn der hgdiobj-Parameter ein Handle für eine logische Palette ist, weist UnrealizeObject das System an, die Palette so zu realisieren, als wäre sie zuvor nicht realisiert worden. Wenn die Anwendung das nächste Mal die RealizePalette-Funktion für die angegebene Palette aufruft, ordnet das System die logische Palette vollständig der Systempalette zu.

Syntax

BOOL UnrealizeObject(
       HGDIOBJ h
);

Parameter

h

Rückgabewert

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

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Die UnrealizeObject-Funktion sollte nicht mit Bestandsobjekten verwendet werden. Beispielsweise ist die Standardpalette, die durch Aufrufen von GetStockObject (DEFAULT_PALETTE) abgerufen wird, ein Stock-Objekt.

Eine durch hgdiobj identifizierte Palette kann die derzeit ausgewählte Palette eines Gerätekontexts sein.

Wenn hgdiobj ein Pinsel ist, bewirkt UnrealizeObject nichts, und die Funktion gibt TRUE zurück. Verwenden Sie SetBrushOrgEx , um den Ursprung eines Pinsels festzulegen.

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 (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll

Weitere Informationen

Farbfunktionen

Übersicht über Farben

GetStockObject

RealizePalette

SetBrushOrgEx