Freigeben über


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

Weitere Informationen

Farbfunktionen

Übersicht über Farben

GetDeviceCaps

GetPaletteEntries

PALETTEENTRY

RealizePalette