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
Library Windowscodecs.lib
DLL Windowscodecs.dll