DwmGetColorizationColor 함수(dwmapi.h)

DWM(데스크톱 창 관리자) 유리 컴퍼지션에 사용되는 현재 색을 검색합니다. 이 값은 현재 색 구성표를 기반으로 하며 사용자가 수정할 수 있습니다. 애플리케이션은 WM_DWMCOLORIZATIONCOLORCHANGED 알림을 처리하여 색 변경을 수신 대기할 수 있습니다.

구문

HRESULT DwmGetColorizationColor(
  [out] DWORD *pcrColorization,
  [out] BOOL  *pfOpaqueBlend
);

매개 변수

[out] pcrColorization

이 함수가 성공적으로 반환될 때 유리 컴퍼지션에 사용되는 현재 색을 수신하는 값에 대한 포인터입니다. 값의 색 형식은 0xAARRGGBB입니다.

[out] pfOpaqueBlend

이 함수가 성공적으로 반환될 때 색이 불투명 혼합인지 여부를 나타내는 값에 대한 포인터입니다. TRUE 이면 색이 불투명하게 혼합됩니다. 그렇지 않으면 FALSE입니다.

반환 값

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

pcrColorization에서 가리키는 값은 0xAARRGGBB 형식입니다. COLORREF와 같은 많은 Microsoft Win32 API는 0x00BBGGRR 형식을 사용합니다. 의도한 색이 사용되는지 주의해야 합니다.

예제

다음 예제 코드는 WM_DWMCOLORIZATIONCOLORCHANGED 알림 핸들을 보여줍니다. 색 지정 알림이 수신되면 이 코드는 새 색 값을 검색합니다.

...
DWORD color = 0;
BOOL opaque = FALSE;
  
HRESULT hr = DwmGetColorizationColor(&color, &opaque);
if (SUCCEEDED(hr))
{
  // Update the application to use the new color.
}
...

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	dwmapi.h
라이브러리	Dwmapi.lib
DLL	Dwmapi.dll