共用方式為


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 種色彩的調色盤,透明調色盤專案將會取代預先定義的調色盤中的最後一個專案。

規格需求

需求
最低支援的用戶端 Windows XP 搭配 SP2、Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 wincodec.h
程式庫 Windowscodecs.lib
Dll Windowscodecs.dll