次の方法で共有


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 オブジェクトへのポインター。 palettetypePaletteTypeOptimal に設定されていて、optimalColors が正の整数に設定されている場合は、このパラメーターを Bitmap オブジェクトのアドレスに設定します。 それ以外の場合は、このパラメーターを NULL に設定 します

戻り値

種類: 状態

メソッドが成功した場合は、Status 列挙体の要素である Ok を返します

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー gdiplusheaders.h (Gdiplus.h を含む)
Library Gdiplus.lib
[DLL] Gdiplus.dll

こちらもご覧ください

Bitmap