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