共用方式為

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