OleTranslateColor 函数 (olectl.h)

将 OLE_COLOR 类型转换为 COLORREF。

语法

WINOLECTLAPI OleTranslateColor(
  [in]  OLE_COLOR clr,
  [in]  HPALETTE  hpal,
  [out] COLORREF  *lpcolorref
);

参数

[in] clr

要转换为 COLORREF 的 OLE 颜色。

[in] hpal

用作转换基础的调色板。

[out] lpcolorref

指向调用方变量的指针，该变量接收转换后的 COLORREF 结果。 此参数可以为 NULL，表示调用方只想验证转换后的颜色是否存在。

返回值

此函数支持E_INVALIDARG和E_UNEXPECTED的标准返回值，以及以下值。

返回代码	说明
S_OK	已成功转换颜色。

注解

下表描述了颜色转换。

OLE_COLOR	hPal	COLORREF
无效		未定义 (E_INVALIDARG)
0x800000xx，xx 不是有效的 GetSysColor 索引		未定义 (E_INVALIDARG)
	无效	未定义 (E_INVALIDARG)
0x0100i iii， iiii 不是有效的调色板索引	有效调色板	未定义 (E_INVALIDARG)
0x800000xx，xx 是有效的 GetSysColor 索引	NULL	0x00bbggrr
0x0100i iii， iiii 是有效的调色板索引	NULL	0x0100i iii
0x02bbggrr (调色板相对)	NULL	0x02bbggrr
0x00bbggrr	NULL	0x00bbggrr
0x800000xx，xx 是有效的 GetSysColor 索引	有效调色板	0x00bbggrr
0x0100i iii， iiii 是 hPal 中的有效调色板索引	有效调色板	0x0100i iii
0x02bbggrr (调色板相对)	有效调色板	0x02bbggrr
0x00bbggrr	有效调色板	0x02bbggrr

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	olectl.h
Library	OleAut32.lib
DLL	OleAut32.dll