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

Weitere Informationen

Farbfunktionen

Übersicht über Farben

GetDeviceCaps

RealisierenPalette