DWMWINDOWATTRIBUTE 列挙 (dwmapi.h)

DwmGetWindowAttribute および DwmSetWindowAttribute 関数で使用されるオプション。

構文

typedef enum DWMWINDOWATTRIBUTE {
  DWMWA_NCRENDERING_ENABLED,
  DWMWA_NCRENDERING_POLICY,
  DWMWA_TRANSITIONS_FORCEDISABLED,
  DWMWA_ALLOW_NCPAINT,
  DWMWA_CAPTION_BUTTON_BOUNDS,
  DWMWA_NONCLIENT_RTL_LAYOUT,
  DWMWA_FORCE_ICONIC_REPRESENTATION,
  DWMWA_FLIP3D_POLICY,
  DWMWA_EXTENDED_FRAME_BOUNDS,
  DWMWA_HAS_ICONIC_BITMAP,
  DWMWA_DISALLOW_PEEK,
  DWMWA_EXCLUDED_FROM_PEEK,
  DWMWA_CLOAK,
  DWMWA_CLOAKED,
  DWMWA_FREEZE_REPRESENTATION,
  DWMWA_PASSIVE_UPDATE_MODE,
  DWMWA_USE_HOSTBACKDROPBRUSH,
  DWMWA_USE_IMMERSIVE_DARK_MODE = 20,
  DWMWA_WINDOW_CORNER_PREFERENCE = 33,
  DWMWA_BORDER_COLOR,
  DWMWA_CAPTION_COLOR,
  DWMWA_TEXT_COLOR,
  DWMWA_VISIBLE_FRAME_BORDER_THICKNESS,
  DWMWA_SYSTEMBACKDROP_TYPE,
  DWMWA_LAST
} ;

定数

DWMWA_NCRENDERING_ENABLED 大事な DWMWA_NCRENDERING_ENABLED の値は 1 です。 cpp<br>typedef enum DWMWINDOWATTRIBUTE {<br> DWMWA_NCRENDERING_ENABLED = 1,<br> DWMWA_NCRENDERING_POLICY,<br> ...<br> DwmGetWindowAttributeで使用します。 クライアント以外のレンダリングが有効になっているかどうかを検出します。 取得された値は、BOOL型です。 クライアント以外のレンダリングが有効になっている場合は TRUE を します。それ以外の場合は、FALSEを します。
DWMWA_NCRENDERING_POLICY DwmSetWindowAttribute使用します。 クライアント以外のレンダリング ポリシーを設定します。 pvAttribute パラメーターは、DWMNCRENDERINGPOLICY 列挙型の値を指します。
DWMWA_TRANSITIONS_FORCEDISABLED DwmSetWindowAttribute使用します。 DWM 遷移を有効または強制的に無効にします。 pvAttribute パラメーターは、BOOL型の値を指します。 遷移を無効にするには TRUE を し、遷移を有効にするには FALSE を します。
DWMWA_ALLOW_NCPAINT DwmSetWindowAttribute使用します。 クライアント以外の領域でレンダリングされたコンテンツを DWM によって描画されたフレームに表示できるようにします。 pvAttribute パラメーターは、BOOL型の値を指します。 TRUE を使用して、クライアント以外の領域にレンダリングされたコンテンツをフレームに表示できるようにします。それ以外の場合は、FALSEを します。
DWMWA_CAPTION_BUTTON_BOUNDS DwmGetWindowAttributeで使用します。 ウィンドウ相対スペース内のキャプション ボタン領域の境界を取得します。 取得した値は RECT型です。 ウィンドウが最小化されている場合、またはユーザーに表示されない場合、取得 RECT の値は未定義になります。 取得した RECT に使用できる境界が含まれているかどうかを確認する必要があります。そうでない場合は、ウィンドウが最小化されているか、表示されないと結論付けることができます。
DWMWA_NONCLIENT_RTL_LAYOUT DwmSetWindowAttribute使用します。 クライアント以外のコンテンツが右から左 (RTL) にミラー化されるかどうかを指定します。 pvAttribute パラメーターは、BOOL型の値を指します。 クライアント以外のコンテンツが右から左 (RTL) にミラー化されている場合は TRUE。それ以外の場合は、FALSEを します。
DWMWA_FORCE_ICONIC_REPRESENTATION DwmSetWindowAttribute使用します。 ウィンドウのライブまたはスナップショット表現が使用可能な場合でも、アイコンのサムネイルまたはピーク表現 (静的ビットマップ) をウィンドウに強制的に表示します。 この値は通常、ウィンドウの作成時に設定され、ウィンドウの有効期間中は変更されません。 ただし、一部のシナリオでは、時間の経過と同時に値の変更が必要になる場合があります。 pvAttribute パラメーターは、BOOL型の値を指します。 TRUE、象徴的なサムネイルまたはピーク表現を必要とします。それ以外の場合は、FALSEを します。
DWMWA_FLIP3D_POLICY DwmSetWindowAttribute使用します。 Flip3D によるウィンドウの処理方法を設定します。 pvAttribute パラメーターは、DWMFLIP3DWINDOWPOLICY 列挙型の値を指します。
DWMWA_EXTENDED_FRAME_BOUNDS DwmGetWindowAttributeで使用します。 画面空間内の拡張フレーム境界の四角形を取得します。 取得した値は RECT型です。
DWMWA_HAS_ICONIC_BITMAP DwmSetWindowAttribute使用します。 ウィンドウには、DWM で使用するビットマップが、ウィンドウのアイコンサムネイルまたはピーク表現 (静的ビットマップ) として提供されます。 DWMWA_HAS_ICONIC_BITMAP は DWMWA_FORCE_ICONIC_REPRESENTATIONで指定できます。 DWMWA_HAS_ICONIC_BITMAP は通常、ウィンドウの作成時に設定され、ウィンドウの有効期間中は変更されません。 ただし、一部のシナリオでは、時間の経過と同時に値の変更が必要になる場合があります。 pvAttribute パラメーターは、BOOL型の値を指します。 TRUE 、ウィンドウが象徴的なサムネイルまたはピーク表現を提供することを DWM に通知します。それ以外の場合は、FALSEを します。 Windows Vista 以前の : この値はサポートされていません。
DWMWA_DISALLOW_PEEK DwmSetWindowAttribute使用します。 ウィンドウのプレビュープレビューを表示しないでください。 ピーク ビューには、タスク バーのウィンドウのサムネイルにマウス ポインターを合わせると、ウィンドウのフルサイズのプレビューが表示されます。 この属性が設定されている場合、ウィンドウのサムネイルの上にマウス ポインターを置くとピークが閉じます (グループ内の別のウィンドウにプレビューが表示されている場合)。 pvAttribute パラメーターは、BOOL型の値を指します。 ピーク機能を防ぐために TRUE を するか、FALSE を して許可します。 Windows Vista 以前の : この値はサポートされていません。
DWMWA_EXCLUDED_FROM_PEEK DwmSetWindowAttribute使用します。 ピークが呼び出されたときにウィンドウがガラス シートにフェードするのを防ぎます。 pvAttribute パラメーターは、BOOL型の値を指します。 別のウィンドウのピーク中にウィンドウがフェードするのを防ぐために TRUE を するか、通常の動作のために FALSE を します。 Windows Vista 以前の : この値はサポートされていません。
DWMWA_CLOAK DwmSetWindowAttribute使用します。 ユーザーに表示されないようにウィンドウをクロークします。 ウィンドウは引き続き DWM によって構成されます。 DirectComposition での使用: DWMWA_CLOAK フラグを使用して、階層化された子ウィンドウに関連付けられている DirectComposition ビジュアルを使用してウィンドウのコンテンツの表現をアニメーション化するときに、階層化された子ウィンドウをクロークします。 この使用方法の詳細については、「階層化された子ウィンドウのビットマップをアニメーション化する方法」を参照してください。 Windows 7 以前 : この値はサポートされていません。
DWMWA_CLOAKED DwmGetWindowAttributeで使用します。 ウィンドウがクロークされている場合は、その理由を説明する次のいずれかの値を指定します。 DWM_CLOAKED_APP (値0x00000001)。 ウィンドウは所有者アプリケーションによってクロークされました。 DWM_CLOAKED_SHELL (値0x00000002)。 窓はシェルによって覆われました。 DWM_CLOAKED_INHERITED (値0x00000004)。 クローク値は所有者ウィンドウから継承されました。 Windows 7 以前 : この値はサポートされていません。
DWMWA_FREEZE_REPRESENTATION DwmSetWindowAttribute使用します。 ウィンドウのサムネイル画像を現在のビジュアルで固定します。 ウィンドウの内容に合わせてサムネイル画像に対してそれ以上ライブアップデートを行わないでください。 Windows 7 以前 : この値はサポートされていません。
DWMWA_USE_HOSTBACKDROPBRUSH DwmSetWindowAttribute使用します。 UWP 以外のウィンドウでホストの背景ブラシを使用できるようにします。 このフラグが設定されている場合、Windows::UI::Composition API 呼び出す Win32 アプリは、ホスト背景ブラシを使用して透明度効果を構築できます (「Compositor.CreateHostBackdropBrush参照)。 pvAttribute パラメーターは、BOOL型の値を指します。 ウィンドウのホスト背景ブラシを有効にするには TRUE を するか、FALSE を して無効にします。 この値は、Windows 11 ビルド 22000 以降でサポートされています。
DWMWA_USE_IMMERSIVE_DARK_MODE DwmSetWindowAttribute使用します。 ダーク モード のシステム設定が有効になっている場合に、このウィンドウのウィンドウ フレームをダーク モードの色で描画できるようにします。 互換性の理由から、システム設定に関係なく、すべてのウィンドウが既定でライト モードになります。 pvAttribute パラメーターは、BOOL型の値を指します。 ウィンドウ 暗いモードを使用する場合は TRUE、常にライト モードを使用するには FALSE を します。 この値は、Windows 11 ビルド 22000 以降でサポートされています。
DWMWA_WINDOW_CORNER_PREFERENCE DwmSetWindowAttribute使用します。 ウィンドウの角を丸めた設定を指定します。 pvAttribute パラメーターは、DWM_WINDOW_CORNER_PREFERENCE型の値を指します。 この値は、Windows 11 ビルド 22000 以降でサポートされています。
DWMWA_BORDER_COLOR DwmSetWindowAttribute使用します。 ウィンドウの境界線の色を指定します。 pvAttribute パラメーターは、COLORREF型の値を指します。 アプリは、ウィンドウのアクティブ化の変更など、状態の変化に応じて境界線の色を変更する役割を担います。 色の DWMWA_COLOR_NONE (値0xFFFFFFFE) を指定すると、ウィンドウの境界線の描画が抑制されます。 これにより、罫線のない丸いウィンドウを作成できます。 色に DWMWA_COLOR_DEFAULT (値0xFFFFFFFF) を指定すると、境界線の色に対するシステムの既定の動作を使用するようにウィンドウがリセットされます。 この値は、Windows 11 ビルド 22000 以降でサポートされています。
DWMWA_CAPTION_COLOR DwmSetWindowAttribute使用します。 キャプションの色を指定します。 pvAttribute パラメーターは、COLORREF型の値を指します。 色に DWMWA_COLOR_DEFAULT (値0xFFFFFFFF) を指定すると、キャプションの色に対するシステムの既定の動作を使用するようにウィンドウがリセットされます。 この値は、Windows 11 ビルド 22000 以降でサポートされています。
DWMWA_TEXT_COLOR DwmSetWindowAttribute使用します。 キャプション テキストの色を指定します。 pvAttribute パラメーターは、COLORREF型の値を指します。 色に DWMWA_COLOR_DEFAULT (値0xFFFFFFFF) を指定すると、キャプション テキストの色に対するシステムの既定の動作を使用するようにウィンドウがリセットされます。 この値は、Windows 11 ビルド 22000 以降でサポートされています。
DWMWA_VISIBLE_FRAME_BORDER_THICKNESS DwmGetWindowAttributeで使用します。 DWM がこのウィンドウの周囲に描画する外側の境界線の幅を取得します。 値は、ウィンドウの DPI によって異なる場合があります。 pvAttribute パラメーターは、UINT型の値を指します。 この値は、Windows 11 ビルド 22000 以降でサポートされています。
DWMWA_SYSTEMBACKDROP_TYPE DwmGetWindowAttribute または dwmSetWindowAttribute使用します。 クライアント以外の領域の背後を含む、ウィンドウのシステム描画の背景マテリアルを取得または指定します。 pvAttribute パラメーターは、DWM_SYSTEMBACKDROP_TYPE型の値を指します。 この値は、Windows 11 ビルド 22621 以降でサポートされています。
DWMWA_LAST 検証のために使用される DWMWINDOWATTRIBUTE 値 認識される最大値。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2008 [デスクトップ アプリのみ]
ヘッダー	dwmapi.h

関連項目

• DwmGetWindowAttribute 関数の
• DwmSetWindowAttribute 関数 を する
• DWM コンポジション を有効にして制御する