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 iiii， iiii 不是有效的調色盤索引	有效的調色盤	未定義的 (E_INVALIDARG)
0x800000xx，xx 是有效的 GetSysColor 索引	NULL	0x00bbggrr
0x0100i iiii 是有效的調色盤索引	NULL	0x0100i iii
0x02bbggrr (調色盤相對)	NULL	0x02bbggrr
0x00bbggrr	NULL	0x00bbggrr
0x800000xx，xx 是有效的 GetSysColor 索引	有效的調色盤	0x00bbggrr
0x0100ihs， iiii 是 hPal 中有效的調色盤索引	有效的調色盤	0x0100i iii
0x02bbggrr (調色盤相對)	有效的調色盤	0x02bbggrr
0x00bbggrr	有效的調色盤	0x02bbggrr

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	olectl.h
程式庫	OleAut32.lib
Dll	OleAut32.dll