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
無効		Undefined (E_INVALIDARG)
0x800000xx、xx は有効な GetSysColor インデックスではありません		Undefined (E_INVALIDARG)
	無効	Undefined (E_INVALIDARG)
0x0100iiii、iiii は有効なパレットインデックスではありません	有効なパレット	Undefined (E_INVALIDARG)
0x800000xx、xx は有効な GetSysColor インデックスです	NULL	0x00bbggrr
0x0100iiii、iiii は有効なパレットインデックスです	NULL	0x0100iiii
0x02bbggrr (パレット相対)	NULL	0x02bbggrr
0x00bbggrr	NULL	0x00bbggrr
0x800000xx、xx は有効な GetSysColor インデックスです	有効なパレット	0x00bbggrr
0x0100iiii、iiii は hPal の有効なパレットインデックスです	有効なパレット	0x0100iiii
0x02bbggrr (パレット相対)	有効なパレット	0x02bbggrr
0x00bbggrr	有効なパレット	0x02bbggrr

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	olectl.h
Library	OleAut32.lib
[DLL]	OleAut32.dll