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
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 型の値を指します。 ウィンドウが象徴的なサムネイルまたはピーク表現を提供することを DWM に通知する場合は TRUE。それ以外の場合は 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 [デスクトップ アプリのみ]
Header dwmapi.h

こちらもご覧ください