DWMWINDOWATTRIBUTE-Enumeration (dwmapi.h)

  • Artikel

Optionen, die von den Funktionen DwmGetWindowAttribute und DwmSetWindowAttribute verwendet werden.

Syntax

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
} ;

Konstanten

 
DWMWA_NCRENDERING_ENABLED
Verwenden Sie mit DwmGetWindowAttribute. Ermittelt, ob das Rendering ohne Client aktiviert ist. Der abgerufene Wert ist vom Typ BOOL. TRUE , wenn das Rendering ohne Client aktiviert ist; andernfalls FALSE.
DWMWA_NCRENDERING_POLICY
Verwenden Sie mit DwmSetWindowAttribute. Legt die Nicht-Clientrenderingrichtlinie fest. Der pvAttribute-Parameter verweist auf einen Wert aus der DWMNCRENDERINGPOLICY-Enumeration .
DWMWA_TRANSITIONS_FORCEDISABLED
Verwenden Sie mit DwmSetWindowAttribute. Aktiviert oder deaktiviert DWM-Übergänge. Der parameter pvAttribute verweist auf einen Wert vom Typ BOOL. TRUE zum Deaktivieren von Übergängen oder FALSE zum Aktivieren von Übergängen.
DWMWA_ALLOW_NCPAINT
Verwenden Sie mit DwmSetWindowAttribute. Ermöglicht es, inhalte, die im Nicht-Clientbereich gerendert werden, auf dem von DWM gezeichneten Frame sichtbar zu sein. Der parameter pvAttribute verweist auf einen Wert vom Typ BOOL. TRUE , damit inhalte, die im Nicht-Clientbereich gerendert werden, auf dem Frame sichtbar sind; andernfalls FALSE.
DWMWA_CAPTION_BUTTON_BOUNDS
Verwenden Sie mit DwmGetWindowAttribute. Ruft die Grenzen des Untertitel Schaltflächenbereichs im fensterrelativen Bereich ab. Der abgerufene Wert ist vom Typ RECT. Wenn das Fenster minimiert oder anderweitig für den Benutzer nicht sichtbar ist, ist der Wert des abgerufenen RECT undefiniert. Sie sollten überprüfen, ob das abgerufene RECT eine Grenze enthält, mit der Sie arbeiten können, und wenn dies nicht der Fall ist, können Sie schließen, dass das Fenster minimiert oder anderweitig nicht sichtbar ist.
DWMWA_NONCLIENT_RTL_LAYOUT
Verwenden Sie mit DwmSetWindowAttribute. Gibt an, ob Nicht-Clientinhalte von rechts nach links (RTL) gespiegelt werden. Der parameter pvAttribute verweist auf einen Wert vom Typ BOOL. TRUE , wenn der Nicht-Clientinhalt von rechts nach links (RTL) gespiegelt ist; andernfalls FALSE.
DWMWA_FORCE_ICONIC_REPRESENTATION
Verwenden Sie mit DwmSetWindowAttribute. Erzwingt, dass das Fenster eine ikonische Miniaturansicht oder Vorschaudarstellung (statische Bitmap) anzeigt, auch wenn eine Live- oder Momentaufnahme Darstellung des Fensters verfügbar ist. Dieser Wert wird normalerweise während der Erstellung eines Fensters festgelegt und nicht während der gesamten Lebensdauer des Fensters geändert. In einigen Szenarien kann es jedoch erforderlich sein, dass sich der Wert im Laufe der Zeit ändert. Der parameter pvAttribute verweist auf einen Wert vom Typ BOOL. TRUE , um eine ikonische Miniaturansicht oder Vorschaudarstellung zu erfordern; andernfalls FALSE.
DWMWA_FLIP3D_POLICY
Verwenden Sie mit DwmSetWindowAttribute. Legt fest, wie Flip3D das Fenster behandelt. Der pvAttribute-Parameter verweist auf einen Wert aus der DWMFLIP3DWINDOWPOLICY-Enumeration .
DWMWA_EXTENDED_FRAME_BOUNDS
Verwenden Sie mit DwmGetWindowAttribute. Ruft das Rechteck mit erweiterten Rahmengrenzen im Bildschirmbereich ab. Der abgerufene Wert ist vom Typ RECT.
DWMWA_HAS_ICONIC_BITMAP
Verwenden Sie mit DwmSetWindowAttribute. Das Fenster stellt eine Bitmap zur Verwendung durch DWM als ikonische Miniaturansicht oder Vorschaudarstellung (statische Bitmap) für das Fenster bereit. DWMWA_HAS_ICONIC_BITMAP können mit DWMWA_FORCE_ICONIC_REPRESENTATION angegeben werden. DWMWA_HAS_ICONIC_BITMAP normalerweise während der Erstellung eines Fensters festgelegt und nicht während der gesamten Lebensdauer des Fensters geändert wird. In einigen Szenarien kann es jedoch erforderlich sein, dass sich der Wert im Laufe der Zeit ändert. Der parameter pvAttribute verweist auf einen Wert vom Typ BOOL. TRUE , um DWM darüber zu informieren, dass das Fenster eine ikonische Miniaturansicht oder Vorschaudarstellung bietet; andernfalls FALSE.

Windows Vista und früher: Dieser Wert wird nicht unterstützt.
DWMWA_DISALLOW_PEEK
Verwenden Sie mit DwmSetWindowAttribute. Zeigen Sie keine Vorschau für das Fenster an. Die Vorschauansicht zeigt eine vollständige Vorschau des Fensters, wenn die Maus über die Miniaturansicht des Fensters in der Taskleiste bewegt wird. Wenn dieses Attribut festgelegt ist, wird beim Bewegen des Mauszeigers auf die Miniaturansicht des Fensters die Vorschau verworfen (falls in einem anderen Fenster in der Gruppe eine Vorschau angezeigt wird). Der parameter pvAttribute verweist auf einen Wert vom Typ BOOL. TRUE , um die Peek-Funktionalität zu verhindern, oder FALSE , um dies zuzulassen.

Windows Vista und früher: Dieser Wert wird nicht unterstützt.
DWMWA_EXCLUDED_FROM_PEEK
Verwenden Sie mit DwmSetWindowAttribute. Verhindert, dass ein Fenster auf eine Glasscheibe verblasst, wenn ein Blick aufgerufen wird. Der parameter pvAttribute verweist auf einen Wert vom Typ BOOL. TRUE , um zu verhindern, dass das Fenster während des Vorschaufensters eines anderen Fensters verblasst, oder FALSE für normales Verhalten.

Windows Vista und früher: Dieser Wert wird nicht unterstützt.
DWMWA_CLOAK
Verwenden Sie mit DwmSetWindowAttribute. Verhüllt das Fenster so, dass es für den Benutzer nicht sichtbar ist. Das Fenster besteht weiterhin aus DWM.

Verwenden mit DirectComposition: Verwenden Sie das DWMWA_CLOAK-Flag, um das untergeordnete Mehrschichtfenster zu verschließen, wenn Sie eine Darstellung des Fensterinhalts über ein DirectComposition-Visual animieren, das dem untergeordneten Mehrschichtfenster zugeordnet wurde. Weitere Informationen zu diesem Anwendungsfall finden Sie unter Animieren der Bitmap eines mehrschichtigen untergeordneten Fensters.

Windows 7 und früher: Dieser Wert wird nicht unterstützt.
DWMWA_CLOAKED
Verwenden Sie mit DwmGetWindowAttribute. Wenn das Fenster verhüllt ist, stellt einen der folgenden Werte bereit, der den Grund dafür erklärt.

DWM_CLOAKED_APP (Wert 0x00000001). Das Fenster wurde von seiner Besitzeranwendung verhüllt.

DWM_CLOAKED_SHELL (Wert 0x00000002). Das Fenster wurde von der Shell verhüllt.

DWM_CLOAKED_INHERITED (Wert 0x00000004). Der Umhangwert wurde vom Besitzerfenster geerbt.

Windows 7 und früher: Dieser Wert wird nicht unterstützt.
DWMWA_FREEZE_REPRESENTATION
Verwenden Sie mit DwmSetWindowAttribute. Frieren Sie die Miniaturansicht des Fensters mit den aktuellen Visuals ein. Führen Sie keine weiteren Liveupdates für das Miniaturbild aus, um dem Inhalt des Fensters zu entsprechen.

Windows 7 und früher: Dieser Wert wird nicht unterstützt.
DWMWA_USE_HOSTBACKDROPBRUSH
Verwenden Sie mit DwmSetWindowAttribute. Ermöglicht einem Nicht-UWP-Fenster die Verwendung von Hostkulissenpinsel. Wenn dieses Flag festgelegt ist, kann eine Win32-App, die Windows::UI::Composition-APIs aufruft, Mithilfe des Hosthintergrundpinsels Transparenzeffekte erstellen (siehe Compositor.CreateHostBackdropBrush). Der parameter pvAttribute verweist auf einen Wert vom Typ BOOL. TRUE , um Hostkulissenpinsel für das Fenster zu aktivieren, oder FALSE , um es zu deaktivieren.

Dieser Wert wird ab Windows 11 Build 22000 unterstützt.
DWMWA_USE_IMMERSIVE_DARK_MODE
Verwenden Sie mit DwmSetWindowAttribute. Ermöglicht das Zeichnen des Fensterrahmens für dieses Fenster in dunklen Farben, wenn die Systemeinstellung für den dunklen Modus aktiviert ist. Aus Kompatibilitätsgründen wird bei allen Fenstern standardmäßig der Lichtmodus verwendet, unabhängig von der Systemeinstellung. Der parameter pvAttribute verweist auf einen Wert vom Typ BOOL. TRUE , um den dunklen Modus für das Fenster zu berücksichtigen, FALSE , um immer den hellen Modus zu verwenden.

Dieser Wert wird ab Windows 11 Build 22000 unterstützt.
DWMWA_WINDOW_CORNER_PREFERENCE
Verwenden Sie mit DwmSetWindowAttribute. Gibt die Voreinstellung für abgerundete Ecken für ein Fenster an. Der pvAttribute-Parameter verweist auf einen Wert vom Typ DWM_WINDOW_CORNER_PREFERENCE.

Dieser Wert wird ab Windows 11 Build 22000 unterstützt.
DWMWA_BORDER_COLOR
Verwenden Sie mit DwmSetWindowAttribute. Gibt die Farbe des Fensterrahmens an. Der parameter pvAttribute verweist auf einen Wert vom Typ COLORREF. Die App ist für die Änderung der Rahmenfarbe gemäß Zustandsänderungen verantwortlich, z. B. eine Änderung der Fensteraktivierung.

Wenn Sie DWMWA_COLOR_NONE (Wert 0xFFFFFFFE) für die Farbe angeben, wird die Zeichnung des Fensterrahmens unterdrückt. Dadurch ist es möglich, ein abgerundetes Fenster ohne Rahmen zu haben.

Wenn Sie DWMWA_COLOR_DEFAULT (Wert 0xFFFFFFFF) für die Farbe angeben, wird das Fenster auf das Standardverhalten des Systems für die Rahmenfarbe zurückgesetzt.

Dieser Wert wird ab Windows 11 Build 22000 unterstützt.
DWMWA_CAPTION_COLOR
Verwenden Sie mit DwmSetWindowAttribute. Gibt die Farbe des Untertitel an. Der parameter pvAttribute verweist auf einen Wert vom Typ COLORREF.

Wenn Sie DWMWA_COLOR_DEFAULT (Wert 0xFFFFFFFF) für die Farbe angeben, wird das Fenster auf das Standardverhalten des Systems für die Untertitel Farbe zurückgesetzt.

Dieser Wert wird ab Windows 11 Build 22000 unterstützt.
DWMWA_TEXT_COLOR
Verwenden Sie mit DwmSetWindowAttribute. Gibt die Farbe des Untertitel Texts an. Der parameter pvAttribute verweist auf einen Wert vom Typ COLORREF.

Wenn Sie DWMWA_COLOR_DEFAULT (Wert 0xFFFFFFFF) für die Farbe angeben, wird das Fenster auf das Standardverhalten des Systems für die Untertitel Textfarbe zurückgesetzt.

Dieser Wert wird ab Windows 11 Build 22000 unterstützt.
DWMWA_VISIBLE_FRAME_BORDER_THICKNESS
Verwenden Sie mit DwmGetWindowAttribute. Ruft die Breite des äußeren Rahmens ab, den der DWM um dieses Fenster zeichnen würde. Der Wert kann je nach DPI des Fensters variieren. Der parameter pvAttribute verweist auf einen Wert vom Typ UINT.

Dieser Wert wird ab Windows 11 Build 22000 unterstützt.
DWMWA_SYSTEMBACKDROP_TYPE
Verwenden Sie mit DwmGetWindowAttribute oder DwmSetWindowAttribute. Ruft das systemgezeichnete Hintergrundmaterial eines Fensters ab oder gibt es an, auch hinter dem Nichtclientbereich. Der parameter pvAttribute verweist auf einen Wert vom Typ DWM_SYSTEMBACKDROP_TYPE.

Dieser Wert wird ab Windows 11 Build 22621 unterstützt.
DWMWA_LAST
Der maximal erkannte DWMWINDOWATTRIBUTE-Wert , der zu Validierungszwecken verwendet wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile dwmapi.h

Weitere Informationen