GetPaletteEntries-Funktion (wingdi.h)

Artikel
08/27/2023

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