Bitmap::InitializePalette メソッド (gdiplusheaders.h)
Bitmap::InitializePalette メソッドは、標準、最適、またはユーザー設定のカラー パレットを初期化します。
構文
Status InitializePalette(
[in, out] ColorPalette *palette,
[in] PaletteType palettetype,
[in] INT optimalColors,
[in] BOOL useTransparentColor,
[in] Bitmap *bitmap
);
パラメーター
[in, out] palette
種類: ColorPalette*
ColorPalette 構造体の後に ARGB 値の配列が続くバッファーへのポインター。 ColorPalette 構造体の Flags メンバーと Count メンバーを設定する必要があります。 ColorPalette 構造体の Entries メンバーは、1 つの ARGB 値の配列です。 ColorPalette 構造体と、パレット内の追加の ARGB 値にメモリを割り当てる必要があります。 たとえば、パレットに 36 個の ARGB 値がある場合は、 のように malloc(sizeof(ColorPalette) + 35*sizeof(ARGB))
バッファーを割り当てます。
[in] palettetype
種類: PaletteType
パレットの種類を指定する PaletteType 列挙体の要素。 パレットには、複数の標準タイプの 1 つを使用することも、定義したカスタム パレットを使用することもできます。 また、 Bitmap::InitializePalette メソッドは、指定されたビットマップに基づいて最適なパレットを作成できます。
[in] optimalColors
型: INT
指定したビットマップに基づいて、最適なパレットに含める色の数を指定する整数。 このパラメーターが 0 より大きい場合は、 palettetype パラメーターを PaletteTypeOptimal に設定し、 ビットマップ パラメーターが Bitmap オブジェクトを指している必要があります。 最適なパレットではなく標準パレットまたはカスタム パレットを作成する場合は、このパラメーターを 0 に設定します。
[in] useTransparentColor
種類: BOOL
パレットに透明な色を含めるかどうかを示すブール値。 透明色を含めるには 、TRUE に設定します。それ以外の場合 は FALSE。
[in] bitmap
種類: ビットマップ*
最適なパレットが作成される Bitmap オブジェクトへのポインター。 palettetype が PaletteTypeOptimal に設定されていて、optimalColors が正の整数に設定されている場合は、このパラメーターを Bitmap オブジェクトのアドレスに設定します。 それ以外の場合は、このパラメーターを NULL に設定 します。
戻り値
種類: 状態
メソッドが成功した場合は、Status 列挙体の要素である Ok を返します。
メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。
要件
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | gdiplusheaders.h (Gdiplus.h を含む) |
Library | Gdiplus.lib |
[DLL] | Gdiplus.dll |