Bitmap ::InitializePalette, méthode (gdiplusheaders.h)

La méthode Bitmap ::InitializePalette initialise une palette de couleurs standard, optimale ou personnalisée.

Syntaxe

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

Paramètres

[in, out] palette

Type : ColorPalette*

Pointeur vers une mémoire tampon qui contient une structure ColorPalette suivie d’un tableau de valeurs ARGB . Vous devez définir les membres Flags et Count de la structure ColorPalette . Le membre Entries d’une structure ColorPalette est un tableau d’une valeur ARGB . Vous devez allouer de la mémoire pour la structure ColorPalette et pour les valeurs ARGB supplémentaires dans la palette. Par exemple, si la palette a 36 valeurs ARGB , allouez une mémoire tampon comme suit : malloc(sizeof(ColorPalette) + 35*sizeof(ARGB)).

[in] palettetype

Type : PaletteType

Élément de l’énumération PaletteType qui spécifie le type de palette. La palette peut avoir l’un des types standard, ou il peut s’agir d’une palette personnalisée que vous définissez. En outre, la méthode Bitmap ::InitializePalette peut créer une palette optimale basée sur une bitmap spécifiée.

[in] optimalColors

Type : INT

Entier qui spécifie le nombre de couleurs que vous souhaitez avoir dans une palette optimale basée sur une bitmap spécifiée. Si ce paramètre est supérieur à 0, le paramètre palettetype doit être défini sur PaletteTypeOptimal et le paramètre bitmap doit pointer vers un objet Bitmap . Si vous créez une palette standard ou personnalisée plutôt qu’une palette optimale, définissez ce paramètre sur 0.

[in] useTransparentColor

Type : BOOL

Valeur booléenne qui spécifie s’il faut inclure la couleur transparente dans la palette. Définissez sur TRUE pour inclure la couleur transparente ; sinon , FALSE.

[in] bitmap

Type : Bitmap*

Pointeur vers un objet Bitmap pour lequel une palette optimale sera créée. Si palettetype est défini sur PaletteTypeOptimal et optimalColors sur un entier positif, définissez ce paramètre sur l’adresse d’un objet Bitmap . Sinon, définissez ce paramètre sur NULL.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Configuration requise

Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	gdiplusheaders.h (inclure Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll

Voir aussi

Bitmap