GetSystemPaletteUse-Funktion (wingdi.h)

Die GetSystemPaletteUse-Funktion ruft den aktuellen Zustand der Systempalette (physisch) für den angegebenen Gerätekontext (DC) ab.

Syntax

UINT GetSystemPaletteUse(
  [in] HDC hdc
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert der aktuelle Zustand der Systempalette. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
SYSPAL_NOSTATIC	Die Systempalette enthält keine statischen Farben außer Schwarzweiß.
SYSPAL_STATIC	Die Systempalette enthält statische Farben, die sich nicht ändern, wenn eine Anwendung ihre logische Palette realisiert.
SYSPAL_ERROR	Der angegebene Gerätekontext ist ungültig oder unterstützt keine Farbpalette.

Hinweise

Standardmäßig enthält die Systempalette 20 statische Farben, die nicht geändert werden, wenn eine Anwendung ihre logische Palette realisiert. Eine Anwendung kann auf die meisten dieser Farben zugreifen, indem sie die SetSystemPaletteUse-Funktion aufruft.

Der durch den hdc-Parameter identifizierte Gerätekontext muss ein Gerät darstellen, das Farbpaletten unterstützt.

Eine Anwendung kann ermitteln, ob ein Gerät Farbpaletten unterstützt, indem sie die GetDeviceCaps-Funktion aufruft und die RASTERCAPS-Konstante angibt.

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

Weitere Informationen

Farbfunktionen

Übersicht über Farben

GetDeviceCaps

SetSystemPaletteUse