RealizePalette-Funktion (wingdi.h)
Die RealizePalette-Funktion ordnet Paletteneinträge aus der aktuellen logischen Palette der Systempalette zu.
Syntax
UINT RealizePalette(
[in] HDC hdc
);
Parameter
[in] hdc
Ein Handle für den Gerätekontext, in dem eine logische Palette ausgewählt wurde.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl von Einträgen in der logischen Palette, die der Systempalette zugeordnet sind.
Wenn die Funktion fehlschlägt, wird der Rückgabewert GDI_ERROR.
Hinweise
Eine Anwendung kann bestimmen, ob ein Gerät Palettenvorgänge unterstützt, indem sie die GetDeviceCaps-Funktion aufruft und die RASTERCAPS-Konstante angibt.
Die RealizePalette-Funktion ändert die Palette für das Gerät, das dem angegebenen Gerätekontext zugeordnet ist. Wenn der Gerätekontext ein Speicher-DC ist, wird die Farbtabelle für die im DC ausgewählte Bitmap geändert. Wenn der Gerätekontext ein Anzeige-DC ist, wird die physische Palette für dieses Gerät geändert.
Eine logische Palette ist ein Puffer zwischen farbintensiven Anwendungen und dem System, sodass diese Anwendungen so viele Farben wie nötig verwenden können, ohne die von anderen Fenstern angezeigten Farben zu beeinträchtigen.
Wenn das Fenster einer Anwendung den Fokus hat und die RealizePalette-Funktion aufgerufen wird, versucht das System, so viele der angeforderten Farben wie möglich zu realisieren. Gleiches gilt auch für Anwendungen mit inaktiven Fenstern.
Anforderungen
| 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 |