Método Bitmap::InitializePalette (gdiplusheaders.h)

El método Bitmap::InitializePalette inicializa una paleta de colores estándar, óptima o personalizada.

Sintaxis

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

Parámetros

[in, out] palette

Tipo: ColorPalette*

Puntero a un búfer que contiene una estructura ColorPalette seguida de una matriz de valores ARGB . Debe establecer los miembros Flags y Count de la estructura ColorPalette . El miembro Entries de una estructura ColorPalette es una matriz de un valor ARGB . Debe asignar memoria para la estructura ColorPalette y para los valores ARGB adicionales de la paleta. Por ejemplo, si la paleta tiene 36 valores ARGB , asigne un búfer de la siguiente manera: malloc(sizeof(ColorPalette) + 35*sizeof(ARGB)).

[in] palettetype

Tipo: PaletteType

Elemento de la enumeración PaletteType que especifica el tipo de paleta. La paleta puede tener uno de varios tipos estándar o puede ser una paleta personalizada que defina. Además, el método Bitmap::InitializePalette puede crear una paleta óptima basada en un mapa de bits especificado.

[in] optimalColors

Tipo: INT

Entero que especifica el número de colores que desea tener en una paleta óptima basada en un mapa de bits especificado. Si este parámetro es mayor que 0, el parámetro palettetype debe establecerse en PaletteTypeOptimal y el parámetro de mapa de bits debe apuntar a un objeto Bitmap . Si va a crear una paleta estándar o personalizada en lugar de una paleta óptima, establezca este parámetro en 0.

[in] useTransparentColor

Tipo: BOOL

Valor booleano que especifica si se debe incluir el color transparente en la paleta. Establézcalo en TRUE para incluir el color transparente; en caso contrario , FALSE.

[in] bitmap

Tipo: Mapa de bits*

Puntero a un objeto Mapa de bits para el que se creará una paleta óptima. Si palettetype se establece en PaletteTypeOptimal y optimalColors se establece en un entero positivo, establezca este parámetro en la dirección de un objeto Bitmap . De lo contrario, establezca este parámetro en NULL.

Valor devuelto

Tipo: Estado

Si el método se ejecuta correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusheaders.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll

Consulte también

Bitmap