通过

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