GetPaletteEntries-Funktion (wingdi.h)
Die GetPaletteEntries-Funktion ruft einen angegebenen Bereich von Paletteneinträgen aus der angegebenen logischen Palette ab.
Syntax
UINT GetPaletteEntries(
[in] HPALETTE hpal,
[in] UINT iStart,
[in] UINT cEntries,
[out] LPPALETTEENTRY pPalEntries
);
Parameter
[in] hpal
Ein Handle für die logische Palette.
[in] iStart
Der erste Eintrag in der logischen Palette, der abgerufen werden soll.
[in] cEntries
Die Anzahl der Einträge in der logischen Palette, die 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 nEntries-Parameter angegeben.
Rückgabewert
Wenn die Funktion erfolgreich ist und das Handle für die logische Palette ein gültiger Zeiger (nicht NULL) ist, ist der Rückgabewert die Anzahl der Einträge, die aus der logischen Palette abgerufen werden. Wenn die Funktion erfolgreich ist und das Handle für die logische Palette NULL ist, ist der Rückgabewert die Anzahl der Einträge in der angegebenen Palette.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Hinweise
Eine Anwendung kann ermitteln, ob ein Gerät Palettenvorgänge unterstützt, indem sie die GetDeviceCaps-Funktion aufruft und die RASTERCAPS-Konstante angibt.
Wenn der nEntries-Parameter mehr Einträge angibt, als in der Palette vorhanden sind, werden die verbleibenden Elemente der PALETTEENTRY-Struktur nicht geändert.
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 (windows.h einschließen) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |