GetSystemPaletteEntries-Funktion (wingdi.h)

Die GetSystemPaletteEntries-Funktion ruft einen Bereich von Paletteneinträgen aus der Systempalette ab, der dem angegebenen Gerätekontext (Device Context, DC) zugeordnet ist.

Syntax

UINT GetSystemPaletteEntries(
  [in]  HDC            hdc,
  [in]  UINT           iStart,
  [in]  UINT           cEntries,
  [out] LPPALETTEENTRY pPalEntries
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] iStart

Der erste Eintrag, der aus der Systempalette abgerufen werden soll.

[in] cEntries

Die Anzahl der Einträge, die aus der Systempalette abgerufen werden sollen.

[out] pPalEntries

Ein Zeiger auf ein Array von PALETTEENTRY-Strukturen , um die Paletteneinträge zu empfangen. Das Array muss mindestens so viele Strukturen enthalten, wie vom cEntries-Parameter angegeben. Wenn dieser Parameter NULL ist, gibt die Funktion die Gesamtzahl der Einträge in der Palette zurück.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl der Einträge, die aus der Palette abgerufen werden.

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.

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 (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll

Weitere Informationen

Farbfunktionen

Übersicht über Farben

GetDeviceCaps

GetPaletteEntries

PALETTEENTRY