Bitmap::InitializePalette-Methode (gdiplusheaders.h)

Artikel
01/27/2024

Die Bitmap::InitializePalette-Methode initialisiert eine standard-, optimale oder benutzerdefinierte Farbpalette.

Syntax

Status InitializePalette(
  [in, out] ColorPalette *palette,
  [in]      PaletteType  palettetype,
  [in]      INT          optimalColors,
  [in]      BOOL         useTransparentColor,
  [in]      Bitmap       *bitmap
);

Parameter

[in, out] palette

Typ: ColorPalette*

Zeiger auf einen Puffer, der eine ColorPalette-Struktur gefolgt von einem Array von ARGB-Werten enthält. Sie müssen die Elemente Flags und Count der ColorPalette-Struktur festlegen. Das Entries-Element einer ColorPalette-Struktur ist ein Array aus einem ARGB-Wert . Sie müssen Arbeitsspeicher für die ColorPalette-Struktur und für die zusätzlichen ARGB-Werte in der Palette zuweisen. Wenn die Palette beispielsweise 36 ARGB-Werte aufweist, weisen Sie einen Puffer wie folgt zu: malloc(sizeof(ColorPalette) + 35*sizeof(ARGB)).

[in] palettetype

Typ: PaletteType

Element der PaletteType-Enumeration , die den Palettentyp angibt. Die Palette kann einen von mehreren Standardtypen aufweisen, oder es kann sich um eine benutzerdefinierte Palette handeln, die Sie definieren. Außerdem kann die Bitmap::InitializePalette-Methode eine optimale Palette basierend auf einer angegebenen Bitmap erstellen.

[in] optimalColors

Typ: INT

Ganzzahl, die die Anzahl der Farben angibt, die Sie in einer optimalen Palette basierend auf einer angegebenen Bitmap verwenden möchten. Wenn dieser Parameter größer als 0 ist, muss der palettetype-Parameter auf PaletteTypeOptimal festgelegt werden, und der Bitmapparameter muss auf ein Bitmap-Objekt verweisen. Wenn Sie eine Standard- oder benutzerdefinierte Palette anstelle einer optimalen Palette erstellen, legen Sie diesen Parameter auf 0 fest.

[in] useTransparentColor

Typ: BOOL

Boolescher Wert, der angibt, ob die transparente Farbe in die Palette eingeschlossen werden soll. Legen Sie auf TRUE fest, um die transparente Farbe einzuschließen. andernfalls FALSE.

[in] bitmap

Typ: Bitmap*

Zeiger auf ein Bitmap-Objekt , für das eine optimale Palette erstellt wird. Wenn palettetype auf PaletteTypeOptimal und optimalColors auf eine positive ganze Zahl festgelegt ist, legen Sie diesen Parameter auf die Adresse eines Bitmap-Objekts fest. Legen Sie andernfalls diesen Parameter auf NULL fest.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusheaders.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll

Weitere Informationen

Bitmap

Freigeben über