Freigeben über

DWMWINDOWATTRIBUTE-Aufzählung (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

WICHTIG

Der Wert von DWMWA_NCRENDERING_ENABLED ist 1.

cpp<br>typedef enum DWMWINDOWATTRIBUTE {<br> DWMWA_NCRENDERING_ENABLED = 1,<br> DWMWA_NCRENDERING_POLICY,<br> ...<br>

Wird mit DwmGetWindowAttributeverwendet. Ermittelt, ob das Nicht-Client-Rendering aktiviert ist. Der abgerufene Wert ist vom Typ BOOL. TRUE, wenn das Rendering nicht vom Client aktiviert ist; andernfalls FALSE.
DWMWA_NCRENDERING_POLICY
Wird mit DwmSetWindowAttributeverwendet. Legt die Nicht-Client-Renderingrichtlinie fest. Der pvAttribute Parameter verweist auf einen Wert aus der DWMNCRENDERINGPOLICY Enumeration.
DWMWA_TRANSITIONS_FORCEDISABLED
Wird mit DwmSetWindowAttributeverwendet. Aktiviert oder deaktiviert DWM-Übergänge. Der pvAttribute Parameter verweist auf einen Wert vom Typ BOOL. TRUE, um Übergänge zu deaktivieren, oder FALSE-, um Übergänge zu aktivieren.
DWMWA_ALLOW_NCPAINT
Wird mit DwmSetWindowAttributeverwendet. Ermöglicht das Rendern von Inhalten im Nicht-Client-Bereich auf dem von DWM gezeichneten Frame. Der pvAttribute Parameter verweist auf einen Wert vom Typ BOOL. TRUE-, damit inhalte, die im Nicht-Client-Bereich gerendert werden, auf dem Frame sichtbar sind; andernfalls FALSE.
DWMWA_CAPTION_BUTTON_BOUNDS
Wird mit DwmGetWindowAttributeverwendet. Ruft die Grenzen des Bereichs der Beschriftungsschaltfläche im fensterrelativen Bereich ab. Der abgerufene Wert ist vom Typ RECT. Wenn das Fenster für den Benutzer minimiert oder anderweitig nicht sichtbar ist, wird der Wert des RECT- abgerufen und nicht definiert. Sie sollten überprüfen, ob die abgerufene RECT- eine Grenze enthält, mit der Sie arbeiten können, und wenn dies nicht der Fehler ist, können Sie schließen, dass das Fenster minimiert oder anderweitig nicht sichtbar ist.
DWMWA_NONCLIENT_RTL_LAYOUT
Wird mit DwmSetWindowAttributeverwendet. Gibt an, ob Nicht-Client-Inhalte von rechts nach links (RTL) gespiegelt werden. Der pvAttribute Parameter verweist auf einen Wert vom Typ BOOL. TRUE, wenn der Nicht-Client-Inhalt von rechts nach links gespiegelt ist; andernfalls FALSE.
DWMWA_FORCE_ICONIC_REPRESENTATION
Wird mit DwmSetWindowAttributeverwendet. Erzwingt das Fenster, eine iconic-Miniaturansicht oder Vorschaudarstellung (eine statische Bitmap) anzuzeigen, auch wenn eine Live- oder Momentaufnahmedarstellung 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 pvAttribute Parameter verweist auf einen Wert vom Typ BOOL. TRUE, um eine iconic-Miniaturansicht oder Vorschaudarstellung zu erfordern; andernfalls FALSE.
DWMWA_FLIP3D_POLICY
Wird mit DwmSetWindowAttributeverwendet. Legt fest, wie Flip3D das Fenster behandelt. Der pvAttribute Parameter verweist auf einen Wert aus der DWMFLIP3DWINDOWPOLICY Enumeration.
DWMWA_EXTENDED_FRAME_BOUNDS
Wird mit DwmGetWindowAttributeverwendet. Ruft das Rechteck für erweiterte Rahmengrenzen im Bildschirmbereich ab. Der abgerufene Wert ist vom Typ RECT.
DWMWA_HAS_ICONIC_BITMAP
Wird mit DwmSetWindowAttributeverwendet. Das Fenster stellt eine Bitmap für die Verwendung durch DWM als iconic-Miniaturansicht oder Vorschaudarstellung (eine statische Bitmap) für das Fenster bereit. DWMWA_HAS_ICONIC_BITMAP kann mit DWMWA_FORCE_ICONIC_REPRESENTATIONangegeben werden. DWMWA_HAS_ICONIC_BITMAP 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 pvAttribute Parameter verweist auf einen Wert vom Typ BOOL. TRUE, um DWM darüber zu informieren, dass das Fenster eine iconic-Miniaturansicht oder Vorschaudarstellung bereitstellt; andernfalls FALSE.

Windows Vista und früher: Dieser Wert wird nicht unterstützt.
DWMWA_DISALLOW_PEEK
Wird mit DwmSetWindowAttributeverwendet. Vorschau für das Fenster nicht anzeigen. In der Vorschauansicht wird eine Vorschau des Fensters in voller Größe angezeigt, wenn die Maus auf die Miniaturansicht des Fensters in der Taskleiste zeigt. Wenn dieses Attribut festgelegt ist, wird beim Bewegen des Mauszeigers auf die Miniaturansicht des Fensters ein Vorschaufenster ausgeblendet (falls ein anderes Fenster in der Gruppe eine Vorschau anzeigt). Der pvAttribute Parameter verweist auf einen Wert vom Typ BOOL. TRUE, um Vorschaufunktionen zu verhindern, oder FALSE-, um sie zuzulassen.

Windows Vista und früher: Dieser Wert wird nicht unterstützt.
DWMWA_EXCLUDED_FROM_PEEK
Wird mit DwmSetWindowAttributeverwendet. Verhindert, dass ein Fenster beim Aufrufen eines Vorschaufensters auf ein Glasblatt verblassen wird. Der pvAttribute Parameter verweist auf einen Wert vom Typ BOOL. TRUE, um zu verhindern, dass das Fenster während der Vorschau eines anderen Fensters angezeigt wird, oder FALSE- für normales Verhalten.

Windows Vista und früher: Dieser Wert wird nicht unterstützt.
DWMWA_CLOAK
Wird mit DwmSetWindowAttributeverwendet. Klammert das Fenster so, dass es für den Benutzer nicht sichtbar ist. Das Fenster besteht noch aus DWM.

Verwendung mit DirectComposition: Verwenden Sie das DWMWA_CLOAK Flag, um das mehrschichtige untergeordnete Fenster zu verschließen, wenn Sie eine Darstellung des Inhalts des Fensters über eine DirectComposition-Visualisierung animieren, die dem mehrschichtigen untergeordneten Fenster zugeordnet wurde. Weitere Informationen zu diesem Verwendungsfall finden Sie unter Animieren der Bitmap eines mehrschichtigen untergeordneten Fensters.

Windows 7 und früher: Dieser Wert wird nicht unterstützt.
DWMWA_CLOAKED
Wird mit DwmGetWindowAttributeverwendet. Wenn das Fenster vermantelt ist, wird einer der folgenden Werte bereitgestellt, der erläutert, warum.

DWM_CLOAKED_APP (Wert 0x00000001). Das Fenster wurde von der Besitzeranwendung verworfen.

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

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

Windows 7 und früher: Dieser Wert wird nicht unterstützt.
DWMWA_FREEZE_REPRESENTATION
Wird mit DwmSetWindowAttributeverwendet. Fixieren Sie das Miniaturbild des Fensters mit den aktuellen visuellen Elementen. Führen Sie keine weiteren Liveupdates für das Miniaturbild aus, um den Inhalt des Fensters abzugleichen.

Windows 7 und früher: Dieser Wert wird nicht unterstützt.
DWMWA_USE_HOSTBACKDROPBRUSH
Wird mit DwmSetWindowAttributeverwendet. Ermöglicht es einem Nicht-UWP-Fenster, Hostkulissepinsel zu verwenden. Wenn dieses Flag festgelegt ist, kann eine Win32-App, die Windows::UI::Composition-APIs aufruft, Transparenzeffekte mithilfe des Host-Hintergrundpinsels erstellen (siehe Compositor.CreateHostBackdropBrush). Der pvAttribute Parameter verweist auf einen Wert vom Typ BOOL. TRUE, um Host-Hintergrundpinsel für das Fenster zu aktivieren, oder FALSE- sie zu deaktivieren.

Dieser Wert wird ab Windows 11 Build 22000 unterstützt.
DWMWA_USE_IMMERSIVE_DARK_MODE
Wird mit DwmSetWindowAttributeverwendet. Ermöglicht das Zeichnen des Fensterrahmens für dieses Fenster in dunklen Modusfarben, wenn die Systemeinstellung für den dunklen Modus aktiviert ist. Aus Kompatibilitätsgründen werden alle Fenster unabhängig von der Systemeinstellung standardmäßig im Hellen Modus angezeigt. Der pvAttribute Parameter verweist auf einen Wert vom Typ BOOL. TRUE, um den dunklen Modus für das Fenster zu berücksichtigen, FALSE immer den hellen Modus zu verwenden.

Dieser Wert wird ab Windows 11 Build 22000 unterstützt.
DWMWA_WINDOW_CORNER_PREFERENCE
Wird mit DwmSetWindowAttributeverwendet. Gibt die Einstellung der abgerundeten Ecke 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
Wird mit DwmSetWindowAttributeverwendet. Gibt die Farbe des Fensterrahmens an. Der pvAttribute Parameter verweist auf einen Wert vom Typ COLORREF. Die App ist für das Ändern 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. Dies ermöglicht es, ein abgerundetes Fenster ohne Rahmen zu haben.

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

Dieser Wert wird ab Windows 11 Build 22000 unterstützt.
DWMWA_CAPTION_COLOR
Wird mit DwmSetWindowAttributeverwendet. Gibt die Farbe der Beschriftung an. Der pvAttribute Parameter verweist auf einen Wert vom Typ COLORREF.

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

Dieser Wert wird ab Windows 11 Build 22000 unterstützt.
DWMWA_TEXT_COLOR
Wird mit DwmSetWindowAttributeverwendet. Gibt die Farbe des Beschriftungstexts an. Der pvAttribute Parameter verweist auf einen Wert vom Typ COLORREF.

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

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

Dieser Wert wird ab Windows 11 Build 22000 unterstützt.
DWMWA_SYSTEMBACKDROP_TYPE
Wird mit DwmGetWindowAttribute- oder DwmSetWindowAttribute-verwendet. Dient zum Abrufen oder Angeben des vom System gezeichneten Hintergrundmaterials eines Fensters, einschließlich hinter dem Nicht-Client-Bereich. Der pvAttribute Parameter 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 Überprüfungszwecken verwendet wird.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2008 [Nur Desktop-Apps]
Header- dwmapi.h

Siehe auch