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

Weitere Informationen

Farbfunktionen

Übersicht über Farben

CreatePalette

GetDeviceCaps

SelectPalette