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 |