UpdateColors-Funktion (wingdi.h)
Die UpdateColors-Funktion aktualisiert den Clientbereich des angegebenen Gerätekontexts, indem die aktuellen Farben im Clientbereich auf die aktuell realisierte logische Palette umgestaltet werden.
Syntax
BOOL UpdateColors(
[in] HDC hdc
);
Parameter
[in] hdc
Ein Handle für den Gerätekontext.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Hinweise
Eine Anwendung kann bestimmen, ob ein Gerät Palettenvorgänge unterstützt, indem sie die GetDeviceCaps-Funktion aufruft und die RASTERCAPS-Konstante angibt.
Ein inaktives Fenster mit einer realisierten logischen Palette kann UpdateColors als Alternative zum Neuzeichnen des Clientbereichs aufrufen, wenn sich die Systempalette ändert.
Die UpdateColors-Funktion aktualisiert in der Regel einen Clientbereich schneller als das Neuzeichnen des Bereichs. Da UpdateColors jedoch die Farbübersetzung basierend auf der Farbe jedes Pixels vor der Systempalettenänderung durchführt, führt jeder Aufruf dieser Funktion zu einem Verlust der Farbgenauigkeit.
Diese Funktion muss kurz nach dem Empfang einer WM_PALETTECHANGED Nachricht aufgerufen werden.
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 |