Énumération DWMWINDOWATTRIBUTE (dwmapi.h)

  • Article

Options utilisées par les fonctions DwmGetWindowAttribute et DwmSetWindowAttribute .

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

Constantes

 
DWMWA_NCRENDERING_ENABLED
Utilisez avec DwmGetWindowAttribute. Découvre 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
Utilisez 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
Utilisez 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
Utilisez 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 affiché dans la zone non cliente d’être visible sur le cadre ; sinon, FALSE.
DWMWA_CAPTION_BUTTON_BOUNDS
Utilisez avec DwmGetWindowAttribute. Récupère les limites de la zone de bouton légende dans l’espace relatif de la fenêtre. La valeur récupérée est de type RECT. Si la fenêtre est réduite ou n’est pas visible par l’utilisateur, la valeur du RECT récupéré n’est pas définie. Vous devez case activée si le RECT récupéré contient une limite que vous pouvez utiliser, 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
Utilisez 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
Utilisez avec DwmSetWindowAttribute. Force la fenêtre à afficher une miniature iconique ou une représentation d’aperçu (bitmap statique), même si une représentation dynamique ou instantané de la fenêtre est disponible. Cette valeur est normalement définie lors de la création d’une fenêtre et n’est pas modifiée tout au long de sa durée de vie. Toutefois, certains scénarios peuvent nécessiter une modification de la valeur au fil du temps. Le paramètre pvAttribute pointe vers une valeur de type BOOL. TRUE pour exiger une miniature iconique ou un aperçu de la représentation ; sinon, FALSE.
DWMWA_FLIP3D_POLICY
Utilisez 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
Utilisez avec DwmGetWindowAttribute. Récupère le rectangle de limites de cadre étendu dans l’espace d’écran. La valeur récupérée est de type RECT.
DWMWA_HAS_ICONIC_BITMAP
Utilisez avec DwmSetWindowAttribute. La fenêtre fournit une bitmap à utiliser par DWM en tant que miniature iconique ou représentation d’aperçu (bitmap statique) pour la fenêtre. DWMWA_HAS_ICONIC_BITMAP peut être spécifié avec DWMWA_FORCE_ICONIC_REPRESENTATION. DWMWA_HAS_ICONIC_BITMAP est normalement défini pendant la création d’une fenêtre et n’est pas modifié tout au long de sa durée de vie. Toutefois, certains scénarios peuvent nécessiter une 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 miniature iconique ou une représentation d’aperçu ; sinon, FALSE.

Windows Vista et versions antérieures : Cette valeur n’est pas prise en charge.
DWMWA_DISALLOW_PEEK
Utilisez avec DwmSetWindowAttribute. N’affichez pas d’aperçu de la fenêtre. L’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 fait de pointer le pointeur de la souris sur la miniature de la fenêtre fait disparaître un aperçu (au cas où une autre fenêtre du groupe affiche un aperçu). Le paramètre pvAttribute pointe vers une valeur de type BOOL. TRUE pour empêcher l’aperçu des fonctionnalités, ou FALSE pour l’autoriser.

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

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

Utilisation de avec DirectComposition : Utilisez l’indicateur DWMWA_CLOAK pour masquer la fenêtre enfant superposée lors de l’animation d’une représentation du contenu de la fenêtre via un visuel DirectComposition qui a été associé à la fenêtre enfant superposée. 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
Utilisez 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 de 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
Utilisez avec DwmSetWindowAttribute. Figer l’image miniature de la fenêtre avec ses visuels actuels. Ne faites plus de mises à jour en direct sur l’image miniature pour correspondre au contenu de la fenêtre.

Windows 7 et versions antérieures : Cette valeur n’est pas prise en charge.
DWMWA_USE_HOSTBACKDROPBRUSH
Utilisez 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 les API Windows ::UI ::Composition peut générer des effets de transparence à l’aide du pinceau de fond de l’hôte (voir Compositor.CreateHostBackdropBrush). Le paramètre pvAttribute pointe vers une valeur de type BOOL. TRUE pour activer les pinceaux de fond de l’hôte pour la fenêtre, ou FALSE pour la désactiver.

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

Cette valeur est prise en charge à partir de Windows 11 Build 22000.
DWMWA_WINDOW_CORNER_PREFERENCE
Utilisez 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
Utilisez 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 la bordure en fonction des changements d’état, tels qu’un changement dans l’activation de la 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
Utilisez avec DwmSetWindowAttribute. Spécifie la couleur du 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 légende.

Cette valeur est prise en charge à partir de Windows 11 Build 22000.
DWMWA_TEXT_COLOR
Utilisez avec DwmSetWindowAttribute. Spécifie la couleur du texte 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 légende.

Cette valeur est prise en charge à partir de Windows 11 Build 22000.
DWMWA_VISIBLE_FRAME_BORDER_THICKNESS
Utilisez 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 la 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
Utilisez 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 maximale reconnue, utilisée à des fins de validation.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête dwmapi.h

Voir aussi