Partager via

Énumération DWMWINDOWATTRIBUTE (dwmapi.h)

  • Article

Options utilisées par les fonctions DwmGetWindowAttribute et DwmSetWindowAttribute .

Syntaxe

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

Constantes

 
DWMWA_NCRENDERING_ENABLED

IMPORTANT

La valeur de DWMWA_NCRENDERING_ENABLED est 1.

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

Utiliser avec DwmGetWindowAttribute. Détecte si le rendu non client est activé. La valeur récupérée est de type BOOL. TRUE si le rendu non client est activé ; sinon, FALSE.
DWMWA_NCRENDERING_POLICY
Utiliser avec DwmSetWindowAttribute . Définit la stratégie de rendu non client. Le paramètre pvAttribute pointe vers une valeur de l’énumération DWMNCRENDERINGPOLICY.
DWMWA_TRANSITIONS_FORCEDISABLED
Utiliser avec DwmSetWindowAttribute . Active ou désactive de force les transitions DWM. Le paramètre pvAttribute pointe vers une valeur de type BOOL. TRUE pour désactiver les transitions, ou FALSE pour activer les transitions.
DWMWA_ALLOW_NCPAINT
Utiliser avec DwmSetWindowAttribute . Permet au contenu affiché dans la zone non cliente d’être visible sur le cadre dessiné par DWM. Le paramètre pvAttribute pointe vers une valeur de type BOOL. TRUE pour permettre au contenu rendu dans la zone non cliente d’être visible sur le cadre ; sinon, FALSE.
DWMWA_CAPTION_BUTTON_BOUNDS
Utiliser avec DwmGetWindowAttribute. Récupère les limites de la zone de bouton de légende dans l’espace relatif à la fenêtre. La valeur récupérée est de type RECT. Si la fenêtre est réduite ou non visible par l’utilisateur, la valeur de la RECT récupérée n’est pas définie. Vous devez vérifier si le RECT récupéré contient une limite avec laquelle vous pouvez travailler, et si ce n’est pas le cas, vous pouvez conclure que la fenêtre est réduite ou non visible.
DWMWA_NONCLIENT_RTL_LAYOUT
Utiliser avec DwmSetWindowAttribute . Spécifie si le contenu non client est mis en miroir de droite à gauche (RTL). Le paramètre pvAttribute pointe vers une valeur de type BOOL. TRUE si le contenu non client est mis en miroir de droite à gauche (RTL) ; sinon, FALSE.
DWMWA_FORCE_ICONIC_REPRESENTATION
Utiliser avec DwmSetWindowAttribute . Force la fenêtre à afficher une représentation icônenelle ou visuelle (image bitmap statique), même si une représentation dynamique ou instantanée de la fenêtre est disponible. Cette valeur est normalement définie pendant la création d’une fenêtre et n’est pas modifiée pendant toute la durée de vie de la fenêtre. Toutefois, certains scénarios peuvent nécessiter la modification de la valeur au fil du temps. Le paramètre pvAttribute pointe vers une valeur de type BOOL. TRUE pour exiger une représentation emblématique de miniature ou d’aperçu ; sinon, FALSE.
DWMWA_FLIP3D_POLICY
Utiliser avec DwmSetWindowAttribute . Définit la façon dont Flip3D traite la fenêtre. Le paramètre pvAttribute pointe vers une valeur de l’énumération DWMFLIP3DWINDOWPOLICY.
DWMWA_EXTENDED_FRAME_BOUNDS
Utiliser avec DwmGetWindowAttribute. Récupère le rectangle des limites de cadre étendues dans l’espace d’écran. La valeur récupérée est de type RECT.
DWMWA_HAS_ICONIC_BITMAP
Utiliser avec DwmSetWindowAttribute . La fenêtre fournit une bitmap à utiliser par DWM comme une miniature emblématique ou une représentation d’aperçu (bitmap statique) pour la fenêtre. DWMWA_HAS_ICONIC_BITMAP pouvez être spécifié avec DWMWA_FORCE_ICONIC_REPRESENTATION. DWMWA_HAS_ICONIC_BITMAP normalement est défini pendant la création d’une fenêtre et n’est pas modifié tout au long de la durée de vie de la fenêtre. Toutefois, certains scénarios peuvent nécessiter la modification de la valeur au fil du temps. Le paramètre pvAttribute pointe vers une valeur de type BOOL. TRUE pour informer DWM que la fenêtre fournira une représentation emblématique de miniature ou d’aperçu ; sinon, FALSE.

Windows Vista et versions antérieures : Cette valeur n’est pas prise en charge.
DWMWA_DISALLOW_PEEK
Utiliser avec DwmSetWindowAttribute . N’affichez pas l’aperçu aperçu de la fenêtre. La vue d’aperçu affiche un aperçu complet de la fenêtre lorsque la souris pointe sur la miniature de la fenêtre dans la barre des tâches. Si cet attribut est défini, le pointeur de la souris sur la miniature de la fenêtre ignore l’aperçu (dans le cas où une autre fenêtre du groupe affiche un aperçu aperçu). Le paramètre pvAttribute pointe vers une valeur de type BOOL. TRUE pour empêcher les fonctionnalités d’aperçu, ou FAUX pour l’autoriser.

Windows Vista et versions antérieures : Cette valeur n’est pas prise en charge.
DWMWA_EXCLUDED_FROM_PEEK
Utiliser avec DwmSetWindowAttribute . Empêche une fenêtre de s’évanouir vers une feuille de verre lorsque l’aperçu est appelé. Le paramètre pvAttribute pointe vers une valeur de type BOOL. TRUE pour empêcher la fenêtre de s’évanouir pendant l’aperçu d’une autre fenêtre, ou FAUX pour un comportement normal.

Windows Vista et versions antérieures : Cette valeur n’est pas prise en charge.
DWMWA_CLOAK
Utiliser avec DwmSetWindowAttribute . Cloque la fenêtre de telle sorte qu’elle n’est pas visible par l’utilisateur. La fenêtre est toujours composée par DWM.

Utilisation avec DirectComposition : Utiliser l’indicateur DWMWA_CLOAK pour afficher la fenêtre enfant superposée lors de l’animation d’une représentation du contenu de la fenêtre via un visuel DirectComposition associé à la fenêtre enfant en couches. Pour plus d’informations sur ce cas d’utilisation, consultez Comment animer la bitmap d’une fenêtre enfant en couches.

Windows 7 et versions antérieures : Cette valeur n’est pas prise en charge.
DWMWA_CLOAKED
Utiliser avec DwmGetWindowAttribute. Si la fenêtre est masquée, fournit l’une des valeurs suivantes expliquant pourquoi.

DWM_CLOAKED_APP (valeur 0x00000001). La fenêtre a été masquée par son application propriétaire.

DWM_CLOAKED_SHELL (valeur 0x00000002). La fenêtre a été masquée par l’interpréteur de commandes.

DWM_CLOAKED_INHERITED (valeur 0x00000004). La valeur du manteau a été héritée de sa fenêtre propriétaire.

Windows 7 et versions antérieures : Cette valeur n’est pas prise en charge.
DWMWA_FREEZE_REPRESENTATION
Utiliser avec DwmSetWindowAttribute . Figer l’image miniature de la fenêtre avec ses visuels actuels. N’effectuez pas de mises à jour actives supplémentaires sur l’image miniature pour qu’elle corresponde au contenu de la fenêtre.

Windows 7 et versions antérieures : Cette valeur n’est pas prise en charge.
DWMWA_USE_HOSTBACKDROPBRUSH
Utiliser avec DwmSetWindowAttribute . Permet à une fenêtre non UWP d’utiliser des pinceaux de fond d’hôte. Si cet indicateur est défini, une application Win32 qui appelle Windows ::UI ::Composition API peut générer des effets de transparence à l’aide du pinceau de fond d’hôte (voir Compositor.CreateHostBackdropBrush). Le paramètre pvAttribute pointe vers une valeur de type BOOL. TRUE pour activer les pinceaux de fond d’hôte pour la fenêtre, ou FALSE pour le désactiver.

Cette valeur est prise en charge à partir de Windows 11 Build 22000.
DWMWA_USE_IMMERSIVE_DARK_MODE
Utiliser avec DwmSetWindowAttribute . Permet au cadre de fenêtre de cette fenêtre d’être dessiné en mode sombre lorsque le paramètre système en mode sombre est activé. Pour des raisons de compatibilité, toutes les fenêtres par défaut sont en mode clair, quel que soit le paramètre système. Le paramètre pvAttribute pointe vers une valeur de type BOOL. TRUE pour honorer le mode sombre de la fenêtre, FAUX pour toujours utiliser le mode clair.

Cette valeur est prise en charge à partir de Windows 11 Build 22000.
DWMWA_WINDOW_CORNER_PREFERENCE
Utiliser avec DwmSetWindowAttribute . Spécifie la préférence d’angle arrondi pour une fenêtre. Le paramètre pvAttribute pointe vers une valeur de type DWM_WINDOW_CORNER_PREFERENCE.

Cette valeur est prise en charge à partir de Windows 11 Build 22000.
DWMWA_BORDER_COLOR
Utiliser avec DwmSetWindowAttribute . Spécifie la couleur de la bordure de la fenêtre. Le paramètre pvAttribute pointe vers une valeur de type COLORREF. L’application est chargée de modifier la couleur de bordure en fonction des modifications d’état, telles qu’une modification de l’activation de fenêtre.

La spécification de DWMWA_COLOR_NONE (valeur 0xFFFFFFFE) pour la couleur supprime le dessin de la bordure de la fenêtre. Cela permet d’avoir une fenêtre arrondie sans bordure.

La spécification de DWMWA_COLOR_DEFAULT (valeur 0xFFFFFFFF) pour la couleur réinitialise la fenêtre à l’aide du comportement par défaut du système pour la couleur de bordure.

Cette valeur est prise en charge à partir de Windows 11 Build 22000.
DWMWA_CAPTION_COLOR
Utiliser avec DwmSetWindowAttribute . Spécifie la couleur de la légende. Le paramètre pvAttribute pointe vers une valeur de type COLORREF.

La spécification de DWMWA_COLOR_DEFAULT (valeur 0xFFFFFFFF) pour la couleur réinitialise la fenêtre à l’aide du comportement par défaut du système pour la couleur de légende.

Cette valeur est prise en charge à partir de Windows 11 Build 22000.
DWMWA_TEXT_COLOR
Utiliser avec DwmSetWindowAttribute . Spécifie la couleur du texte de légende. Le paramètre pvAttribute pointe vers une valeur de type COLORREF.

La spécification de DWMWA_COLOR_DEFAULT (valeur 0xFFFFFFFF) pour la couleur réinitialise la fenêtre à l’aide du comportement par défaut du système pour la couleur de texte de légende.

Cette valeur est prise en charge à partir de Windows 11 Build 22000.
DWMWA_VISIBLE_FRAME_BORDER_THICKNESS
Utiliser avec DwmGetWindowAttribute. Récupère la largeur de la bordure externe que le DWM dessinerait autour de cette fenêtre. La valeur peut varier en fonction de l’ppp de la fenêtre. Le paramètre pvAttribute pointe vers une valeur de type UINT.

Cette valeur est prise en charge à partir de Windows 11 Build 22000.
DWMWA_SYSTEMBACKDROP_TYPE
Utiliser avec DwmGetWindowAttribute ou DwmSetWindowAttribute. Récupère ou spécifie le matériau de fond dessiné par le système d’une fenêtre, y compris derrière la zone non cliente. Le paramètre pvAttribute pointe vers une valeur de type DWM_SYSTEMBACKDROP_TYPE.

Cette valeur est prise en charge à partir de Windows 11 Build 22621.
DWMWA_LAST
Valeur DWMWINDOWATTRIBUTE reconnue maximale, utilisée à des fins de validation.

Exigences

Exigence Valeur
client minimum pris en charge Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2008 [applications de bureau uniquement]
d’en-tête dwmapi.h

Voir aussi