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 |