ResizePalette-Funktion (wingdi.h)

Die ResizePalette-Funktion erhöht oder verkleinert die Größe einer logischen Palette basierend auf dem angegebenen Wert.

Syntax

BOOL ResizePalette(
  [in] HPALETTE hpal,
  [in] UINT     n
);

Parameter

[in] hpal

Ein Handle für die zu ändernde Palette.

[in] n

Die Anzahl der Einträge in der Palette, nachdem die Größe der Palette geändert wurde.

Die Anzahl der Einträge ist auf 1024 beschränkt.

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.

Wenn eine Anwendung ResizePalette aufruft, um die Größe der Palette zu verringern, bleiben die Einträge in der geänderten Palette unverändert. Wenn die Anwendung ResizePalette aufruft, um die Palette zu vergrößern, werden die zusätzlichen Paletteneinträge auf Schwarz festgelegt (die Werte rot, grün und blau sind alle 0), und ihre Flags sind auf Null festgelegt.

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