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 |