DwmSetWindowAttribute 関数 (dwmapi.h)

ウィンドウのデスクトップ ウィンドウ マネージャー (DWM) のクライアント以外のレンダリング属性の値を設定します。 プログラミング ガイダンスとコード例については、「 クライアント以外の領域のレンダリングの制御」を参照してください。

構文

HRESULT DwmSetWindowAttribute(
       HWND    hwnd,
       DWORD   dwAttribute,
  [in] LPCVOID pvAttribute,
       DWORD   cbAttribute
);

パラメーター

hwnd

属性値が設定されるウィンドウへのハンドル。

dwAttribute

DWMWINDOWATTRIBUTE 列挙型の値として指定された、設定する値を示すフラグ。 このパラメーターは、設定する属性を指定し、 pvAttribute パラメーターは属性値を含むオブジェクトを指します。

[in] pvAttribute

設定する属性値を含むオブジェクトへのポインター。 値セットの型は 、dwAttribute パラメーターの値によって異なります。 DWMWINDOWATTRIBUTE 列挙トピックは、各フラグの行で、pvAttribute パラメーターにポインターを渡す必要がある値の種類を示します。

cbAttribute

pvAttribute パラメーターを使用して設定される属性値のサイズ (バイト単位)。 値セットの型、つまりサイズ (バイト単位) は、 dwAttribute パラメーターの値によって異なります。

戻り値

型: HRESULT

関数が成功した場合は、S_OK を返します。 それ以外の場合は、 HRESULTエラー コードが返されます。

デスクトップコンポジションが無効になっている場合 (Windows 7 以前)、この関数は DWM_E_COMPOSITIONDISABLEDを返します。

注釈

dwAttribute パラメーターをDWMWA_NCRENDERING_ENABLEDに設定してこの関数を呼び出しても無効です。 クライアント以外のレンダリングを有効または無効にするには、 DWMWA_NCRENDERING_POLICY 属性を使用し、目的の値を設定する必要があります。 詳細とコード例については、「 クライアント以外の領域のレンダリングの制御」を参照してください。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー dwmapi.h
Library Dwmapi.lib
[DLL] Dwmapi.dll;Uxtheme.dll

こちらもご覧ください