DwmEnableBlurBehindWindow

指定されたウィンドウでブラー効果を有効にする。

DwmEnableBlurBehindWindow hWnd, pBlurBehind

hWnd : [intptr] ブラー効果を適用するウィンドウへのハンドル。
pBlurBehind : [var] `[in]` ブラー効果のデータを提供する DWM_BLURBEHIND 構造体へのポインタ。

(プラグイン / モジュール : dwmapi.dll)

解説

指定されたウィンドウでブラー効果を有効にする。

[戻り値]
成功した場合は S_OK を返す。失敗した場合は HRESULT エラーコード。

[備考]
Windows 8 以降ではレンダリング方式の変更により、この関数を呼び出してもブラー効果は適用されない。DWM_BLURBEHIND
構造体の fEnable を TRUE に設定することでブラーを有効化する。この関数は BeginPaint
の直前に呼ぶこと。ウィンドウ内のアルファ値は尊重される。一部の GDI
操作はアルファ値を保持しないため子ウィンドウの扱いには注意が必要。DWM_BLURBEHIND
内のリージョンは呼び出し元の所有となり、呼び出し後すぐに解放可能。この関数はトップレベルウィンドウでのみ呼び出せる。DWM
コンポジションが切り替わるたびに再呼び出しが必要(WM_DWMCOMPOSITIONCHANGED で処理)。

情報