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 成員是一個 ARGB 值的陣列。 您必須為 ColorPalette 結構配置記憶體，以及調色盤中的其他 ARGB 值。 例如，如果調色盤有 36 個 ARGB 值，請配置緩衝區，如下所示： malloc(sizeof(ColorPalette) + 35*sizeof(ARGB))。

[in] palettetype

類型： PaletteType

指定調色盤類型的 PaletteType 列舉專案。 調色盤可以有數種標準類型之一，或者可以是您定義的自定義調色盤。 此外， Bitmap：：InitializePalette 方法可以根據指定的點陣圖建立最佳調色盤。

[in] optimalColors

類型： INT

整數，指定您想要根據指定位圖在最佳調色盤中擁有的色彩數目。 如果此參數大於 0， 則 palettetype 參數必須設定為 PaletteTypeOptimal， 而且位圖 參數必須指向 Bitmap 物件。 如果您要建立標準或自定義調色盤，而不是最佳調色盤，請將此參數設定為 0。

[in] useTransparentColor

類型： BOOL

布爾值，指定是否要在調色盤中包含透明色彩。 設定為 TRUE 以包含透明色彩;否則 為 FALSE。

[in] bitmap

類型： 位圖*

將建立最佳調色盤之 Bitmap 物件的指標。 如果 palettetype 設定為 PaletteTypeOptimal 且 optimizeColors 設定為正整數，請將此參數設定為 Bitmap 物件的位址。 否則，請將此參數設定為 NULL。

傳回值

類型： 狀態

如果方法成功，它會傳回 Ok，這是 Status 列舉的元素。

如果方法失敗，它會傳回 Status 列舉的其中一個其他元素。

規格需求

最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	gdiplusheaders.h (包含 Gdiplus.h)
程式庫	Gdiplus.lib
Dll	Gdiplus.dll

另請參閱

點陣圖