Metodo Bitmap::InitializePalette (gdiplusheaders.h)

Articolo
01/27/2024

Il metodo Bitmap::InitializePalette inizializza una tavolozza colori standard, ottimale o personalizzata.

Sintassi

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

Parametri

[in, out] palette

Tipo: ColorPalette*

Puntatore a un buffer contenente una struttura ColorPalette seguita da una matrice di valori ARGB . È necessario impostare i membri Flag e Count della struttura ColorPalette . Il membro Voci di una struttura ColorPalette è una matrice di un valore ARGB . È necessario allocare memoria per la struttura ColorPalette e per i valori ARGB aggiuntivi nella tavolozza. Ad esempio, se la tavolozza ha 36 valori ARGB , allocare un buffer come indicato di seguito: malloc(sizeof(ColorPalette) + 35*sizeof(ARGB)).

[in] palettetype

Tipo: PaletteType

Elemento dell'enumerazione PaletteType che specifica il tipo di tavolozza. La tavolozza può avere uno dei diversi tipi standard oppure può essere una tavolozza personalizzata definita. Inoltre, il metodo Bitmap::InitializePalette può creare una tavolozza ottimale in base a una bitmap specificata.

[in] optimalColors

Tipo: INT

Intero che specifica il numero di colori che si desidera avere in una tavolozza ottimale in base a una bitmap specificata. Se questo parametro è maggiore di 0, il parametro palettetype deve essere impostato su PaletteTypeOptimal e il parametro bitmap deve puntare a un oggetto Bitmap . Se si crea una tavolozza standard o personalizzata anziché una tavolozza ottimale, impostare questo parametro su 0.

[in] useTransparentColor

Tipo: BOOL

Valore booleano che specifica se includere il colore trasparente nella tavolozza. Impostare su TRUE per includere il colore trasparente; in caso contrario FALSE.

[in] bitmap

Tipo: Bitmap*

Puntatore a un oggetto Bitmap per il quale verrà creata una tavolozza ottimale. Se palettetype è impostato su PaletteTypeOptimal e optimalColors è impostato su un numero intero positivo, impostare questo parametro sull'indirizzo di un oggetto Bitmap . In caso contrario, impostare questo parametro su NULL.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, che è un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusheaders.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll

Vedi anche

Bitmap

Condividi tramite