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 |