SetPaletteEntries-Funktion (wingdi.h)

Artikel
08/27/2023

Die SetPaletteEntries-Funktion legt RGB-Farbwerte (rot, grün, blau) und Flags in einem Bereich von Einträgen in einer logischen Palette fest.

Syntax

UINT SetPaletteEntries(
  [in] HPALETTE           hpal,
  [in] UINT               iStart,
  [in] UINT               cEntries,
  [in] const PALETTEENTRY *pPalEntries
);

Parameter

[in] hpal

Ein Handle für die logische Palette.

[in] iStart

Der erste festzulegende Logische Paletteneintrag.

[in] cEntries

Die Anzahl der festzulegenden Logischen Paletteneinträge.

[in] pPalEntries

Ein Zeiger auf das erste Element eines Arrays von PALETTEENTRY-Strukturen , die die RGB-Werte und -Flags enthalten.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl der Einträge, die in der logischen Palette festgelegt wurden.

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.

Selbst wenn eine logische Palette ausgewählt und realisiert wurde, wirken sich Änderungen an der Palette nicht auf die physische Palette auf der Oberfläche aus. RealizePalette muss erneut aufgerufen werden, um die neue logische Palette auf der Oberfläche festzulegen.

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