IWICPalette：：InitializePredefined 方法 (wincodec.h)

將調色盤初始化為 WICBitmapPaletteType 所指定的其中一個預先定義的調色盤，並選擇性地新增透明色彩。

語法

HRESULT InitializePredefined(
  [in] WICBitmapPaletteType ePaletteType,
  [in] BOOL                 fAddTransparentColor
);

參數

[in] ePaletteType

類型： WICBitmapPaletteType

所需的預先定義調色盤類型。

[in] fAddTransparentColor

類型： BOOL

要加入調色盤的選擇性透明色彩。 如果不需要透明色彩，請使用 0。 初始化為灰階或黑白調色盤時，請將此參數設定為 FALSE。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

如果將透明色彩新增至調色盤，調色盤就不會再預先定義，並傳回為 WICBitmapPaletteTypeCustom。 對於少於 256 個專案的調色盤，透明專案會新增至調色盤結尾， (也就是說，16 色盤會變成 17 色盤) 。 對於具有 256 種色彩的調色盤，透明調色盤專案將會取代預先定義的調色盤中的最後一個專案。

規格需求