描述
初始化标准，最佳或自定义调色板。
C++ 语法
GpStatus WINGDIPAPI GdipInitializePalette( OUT ColorPalette *palette, PaletteType palettetype, INT optimalColors, BOOL useTransparentColor, GpBitmap *bitmap ); |
PowerBASIC 语法
FUNCTION GdipGetEffectParameterSize ( _ BYREF palette AS ColorPalette, _ BYVAL palettetype AS LONG, _ BYVAL optimalColors AS LONG, _ BYVAL useTransparentColor AS LONG, _ BYVAL bitmap AS DWORD _ ) AS LONG |
参数
palette
[in]指向包含ColorPalette结构后跟ARGB值数组的缓冲区的指针。ColorPalette结构的条目成员是一个ARGB值的数组。您必须为ColorPalette结构分配内存，并为调色板中的其他ARGB值分配内存。例如，如果调色板具有36个ARGB值，则按如下所示分配缓冲区：malloc（sizeof（ColorPalette）+ 35 * sizeof（ARGB））。
palettetype
[in]指定调色板类型的PaletteType枚举的元素。调色板可以有几种标准类型之一，也可以是您定义的自定义调色板。此外，GdipBitmapInitializePalette功能可以基于指定的位图创建最佳调色板。
optimalColors
[in]整数，它根据指定的位图指定要在最佳调色板中拥有的颜色数。如果此参数大于0，则palettetype参数必须设置为PaletteTypeOptimal，位图参数必须指向Bitmap对象。如果要创建标准或自定义调色板而不是最佳调色板，请将此参数设置为0。
useTransparentColor
[in]布尔值，指定是否在调色板中包含透明颜色。设置为TRUE以包含透明颜色;否则为FALSE。
bitmap
[in]指向要创建最佳调色板的位图对象的指针。如果palettetype设置为PaletteTypeOptimal并且optimalColors设置为正整数，请将此参数设置为Bitmap对象的地址。否则，将此参数设置为NULL。
返回值
如果函数成功，则返回Ok，它是状态枚举的一个元素。
如果函数失败，它返回状态枚举的其他元素之一。