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 표준 반환 값과 다음 값을 지원합니다.

반환 코드	Description
S_OK	색이 성공적으로 변환되었습니다.

다음 표에서는 색 변환에 대해 설명합니다.

OLE_COLOR	hPal	COLORREF
잘못됨		정의되지 않음(E_INVALIDARG)
0x800000xx, xx는 유효한 GetSysColor 인덱스가 아닙니다.		정의되지 않음(E_INVALIDARG)
	잘못됨	정의되지 않음(E_INVALIDARG)
0x0100iiii, iiii는 유효한 색상표 인덱스가 아닙니다.	유효한 색상표	정의되지 않음(E_INVALIDARG)
0x800000xx, xx는 유효한 GetSysColor 인덱스입니다.	NULL	0x00bbggrr
0x0100iiiiii, 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
라이브러리	OleAut32.lib
DLL	OleAut32.dll