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

こちらもご覧ください