AnimatePalette-Funktion (wingdi.h)

Artikel
03/04/2024

Die AnimatePalette-Funktion ersetzt Einträge in der angegebenen logischen Palette.

Syntax

BOOL AnimatePalette(
  [in] HPALETTE           hPal,
  [in] UINT               iStartIndex,
  [in] UINT               cEntries,
  [in] const PALETTEENTRY *ppe
);

Parameter

[in] hPal

Ein Handle für die logische Palette.

[in] iStartIndex

Der erste logische Paletteneintrag, der ersetzt werden soll.

[in] cEntries

Die Anzahl der zu ersetzenden Einträge.

[in] ppe

Ein Zeiger auf das erste Element in einem Array von PALETTEENTRY-Strukturen , die zum Ersetzen der aktuellen Einträge verwendet werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

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.

Die AnimatePalette-Funktion ändert nur Einträge, deren flag PC_RESERVED im entsprechenden palPalEntry-Member der LOGPALETTE-Struktur festgelegt ist.

Wenn die angegebene Palette dem aktiven Fenster zugeordnet ist, werden die Farben in der Palette sofort ersetzt.

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