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 种颜色的调色板，透明调色板条目将替换预定义调色板中的最后一个条目。

要求