Freigeben über


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

Weitere Informationen

Farbfunktionen

Übersicht über Farben

GetDeviceCaps

GetSystemPaletteEntries

PALETTEENTRY

SetPaletteEntries