SetPaletteEntries-Funktion (wingdi.h)
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 |