DwmEnableBlurBehindWindow 함수(dwmapi.h)

지정된 창에서 흐림 효과를 사용하도록 설정합니다.

구문

HRESULT DwmEnableBlurBehindWindow(
  [in] HWND                 hWnd,
  [in] const DWM_BLURBEHIND *pBlurBehind
);

매개 변수

[in] hWnd

흐리게 숨김 데이터가 적용되는 창에 대한 핸들입니다.

[in] pBlurBehind

흐리게 숨김 데이터를 제공하는 DWM_BLURBEHIND 구조체에 대한 포인터입니다.

반환 값

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

설명

DWM_BLURBEHIND 구조체의 fEnable 멤버를 TRUE로 설정하여 흐림 효과를 사용하도록 설정합니다. 이로 인해 창의 후속 컴퍼지션이 뒤에 있는 콘텐츠를 흐리게 합니다. 효과의 프롬프트 적용을 확인하려면 BeginPaint 호출 바로 전에 이 함수를 호출해야 합니다.

창의 알파 값이 적용되고 흐림 효과의 맨 위에 렌더링하면 이러한 알파 값이 사용됩니다. 창에 있는 모든 픽셀의 알파 값이 올바른지 확인하는 것은 애플리케이션의 책임입니다. 일부 GDI(Windows Graphics Device Interface) 작업은 알파 값을 유지하지 않으므로 자식 창을 표시할 때는 알파 값이 예측할 수 없으므로 주의해야 합니다.

DWM_BLURBEHIND 구조 내에 지정된 지역은 사용자가 호출자로 소유합니다. 지역을 해제하는 것은 호출자의 책임이며 함수 호출이 완료되는 즉시 해제할 수 있습니다.

이 함수는 최상위 창에서만 호출할 수 있습니다. 이 함수가 다른 창 형식에서 호출되면 오류가 발생합니다.

이 함수는 DWM(Desktop Window Manager) 컴퍼지션이 전환될 때마다 호출되어야 합니다. 컴퍼지션 변경 알림에 대한 WM_DWMCOMPOSITIONCHANGED 메시지를 처리합니다.

예제

다음 예제에서는 전체 창 뒤에 흐림 효과를 적용하는 방법을 보여 줍니다.

HRESULT EnableBlurBehind(HWND hwnd)
{
   HRESULT hr = S_OK;

   // Create and populate the Blur Behind structure
   DWM_BLURBEHIND bb = {0};

   // Enable Blur Behind and apply to the entire client area
   bb.dwFlags = DWM_BB_ENABLE;
   bb.fEnable = true;
   bb.hRgnBlur = NULL;

   // Apply Blur Behind
   hr = DwmEnableBlurBehindWindow(hwnd, &bb);
   if (SUCCEEDED(hr))
   {
      // ...
   }
   return hr;
}

요구 사항

추가 정보

DWM 흐림 개요