Compartir a través de

Enumeración DWMWINDOWATTRIBUTE (dwmapi.h)

  • Artículo

Opciones usadas por las funciones DwmGetWindowAttribute y 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
Use con DwmGetWindowAttribute. Detecta si la representación que no es de cliente está habilitada. El valor recuperado es de tipo BOOL. TRUE si la representación no cliente está habilitada; de lo contrario, FALSE.
DWMWA_NCRENDERING_POLICY
Use con DwmSetWindowAttribute. Establece la directiva de representación que no es de cliente. El parámetro pvAttribute apunta a un valor de la enumeración DWMNCRENDERINGPOLICY .
DWMWA_TRANSITIONS_FORCEDISABLED
Use con DwmSetWindowAttribute. Habilita o deshabilita forzosamente las transiciones de DWM. El parámetro pvAttribute apunta a un valor de tipo BOOL. TRUE para deshabilitar las transiciones o FALSE para habilitar las transiciones.
DWMWA_ALLOW_NCPAINT
Use con DwmSetWindowAttribute. Permite que el contenido representado en el área que no es de cliente sea visible en el marco dibujado por DWM. El parámetro pvAttribute apunta a un valor de tipo BOOL. TRUE para permitir que el contenido representado en el área que no es de cliente sea visible en el marco; de lo contrario, FALSE.
DWMWA_CAPTION_BUTTON_BOUNDS
Use con DwmGetWindowAttribute. Recupera los límites del área del botón subtítulo en el espacio relativo a la ventana. El valor recuperado es de tipo RECT. Si la ventana se minimiza o no es visible para el usuario, el valor del RECT recuperado no está definido. Debe comprobar si el RECT recuperado contiene un límite con el que puede trabajar y, si no lo hace, puede concluir que la ventana está minimizada o no visible.
DWMWA_NONCLIENT_RTL_LAYOUT
Use con DwmSetWindowAttribute. Especifica si el contenido que no es de cliente está reflejado de derecha a izquierda (RTL). El parámetro pvAttribute apunta a un valor de tipo BOOL. TRUE si el contenido que no es de cliente está reflejado de derecha a izquierda (RTL); de lo contrario, FALSE.
DWMWA_FORCE_ICONIC_REPRESENTATION
Use con DwmSetWindowAttribute. Obliga a la ventana a mostrar una miniatura emblemática o una representación de inspección (un mapa de bits estático), incluso si hay disponible una representación dinámica o instantánea de la ventana. Este valor se establece normalmente durante la creación de una ventana y no cambia durante la duración de la ventana. Sin embargo, algunos escenarios pueden requerir que el valor cambie con el tiempo. El parámetro pvAttribute apunta a un valor de tipo BOOL. TRUE para requerir una representación icónica en miniatura o inspección; de lo contrario, FALSE.
DWMWA_FLIP3D_POLICY
Use con DwmSetWindowAttribute. Establece cómo Flip3D trata la ventana. El parámetro pvAttribute apunta a un valor de la enumeración DWMFLIP3DWINDOWPOLICY .
DWMWA_EXTENDED_FRAME_BOUNDS
Use con DwmGetWindowAttribute. Recupera el rectángulo de límites de fotograma extendido en el espacio de pantalla. El valor recuperado es de tipo RECT.
DWMWA_HAS_ICONIC_BITMAP
Use con DwmSetWindowAttribute. La ventana proporcionará un mapa de bits para su uso por DWM como una miniatura emblemática o una representación de inspección (un mapa de bits estático) para la ventana. DWMWA_HAS_ICONIC_BITMAP se puede especificar con DWMWA_FORCE_ICONIC_REPRESENTATION. DWMWA_HAS_ICONIC_BITMAP normalmente se establece durante la creación de una ventana y no cambia durante la duración de la ventana. Sin embargo, algunos escenarios pueden requerir que el valor cambie con el tiempo. El parámetro pvAttribute apunta a un valor de tipo BOOL. TRUE para informar a DWM de que la ventana proporcionará una representación icónica en miniatura o inspección; de lo contrario, FALSE.

Windows Vista y versiones anteriores: Este valor no se admite.
DWMWA_DISALLOW_PEEK
Use con DwmSetWindowAttribute. No muestre la vista previa de la ventana. La vista de inspección muestra una vista previa de tamaño completo de la ventana cuando el mouse mantiene el mouse sobre la miniatura de la ventana en la barra de tareas. Si se establece este atributo, al mantener el puntero del mouse sobre la miniatura de la ventana se descarta ver (en caso de que otra ventana del grupo tenga una vista previa de inspección). El parámetro pvAttribute apunta a un valor de tipo BOOL. TRUE para evitar la funcionalidad de inspección o FALSE para permitirla.

Windows Vista y versiones anteriores: Este valor no se admite.
DWMWA_EXCLUDED_FROM_PEEK
Use con DwmSetWindowAttribute. Evita que una ventana se desvane a una hoja de cristal cuando se invoca la vista. El parámetro pvAttribute apunta a un valor de tipo BOOL. TRUE para evitar que la ventana se desvane durante la vista de otra ventana o FALSE para el comportamiento normal.

Windows Vista y versiones anteriores: Este valor no se admite.
DWMWA_CLOAK
Use con DwmSetWindowAttribute. Oculta la ventana de modo que no sea visible para el usuario. La ventana todavía está compuesta por DWM.

Uso con DirectComposition: Use la marca DWMWA_CLOAK para ocultar la ventana secundaria superpuesta al animar una representación del contenido de la ventana a través de un objeto visual DirectComposition asociado a la ventana secundaria superpuesta. Para obtener más información sobre este caso de uso, vea Cómo animar el mapa de bits de una ventana secundaria superpuesta.

Windows 7 y versiones anteriores: Este valor no se admite.
DWMWA_CLOAKED
Use con DwmGetWindowAttribute. Si la ventana está oculta, proporciona uno de los siguientes valores que explican por qué.

DWM_CLOAKED_APP (0x00000001 de valor). La ventana fue ocultada por su aplicación propietaria.

DWM_CLOAKED_SHELL (0x00000002 de valor). La ventana fue ocultada por shell.

DWM_CLOAKED_INHERITED (0x00000004 de valor). El valor de capa se heredó de su ventana de propietario.

Windows 7 y versiones anteriores: Este valor no se admite.
DWMWA_FREEZE_REPRESENTATION
Use con DwmSetWindowAttribute. Inmovilizar la imagen en miniatura de la ventana con sus objetos visuales actuales. No realice más actualizaciones dinámicas en la imagen en miniatura para que coincidan con el contenido de la ventana.

Windows 7 y versiones anteriores: Este valor no se admite.
DWMWA_USE_HOSTBACKDROPBRUSH
Use con DwmSetWindowAttribute. Permite que una ventana que no sea para UWP use pinceles de fondo de host. Si se establece esta marca, una aplicación Win32 que llama a las API de Windows::UI::Composition puede crear efectos de transparencia mediante el pincel de fondo del host (consulte Compositor.CreateHostBackdropBrush). El parámetro pvAttribute apunta a un valor de tipo BOOL. TRUE para habilitar pinceles de fondo de host para la ventana o FALSE para deshabilitarlo.

Este valor se admite a partir de Windows 11 compilación 22000.
DWMWA_USE_IMMERSIVE_DARK_MODE
Use con DwmSetWindowAttribute. Permite dibujar el marco de la ventana para esta ventana en colores en modo oscuro cuando la configuración del sistema en modo oscuro está habilitada. Por motivos de compatibilidad, todas las ventanas predeterminadas son el modo claro, independientemente de la configuración del sistema. El parámetro pvAttribute apunta a un valor de tipo BOOL. TRUE para respetar el modo oscuro de la ventana, FALSE para usar siempre el modo claro.

Este valor se admite a partir de Windows 11 compilación 22000.
DWMWA_WINDOW_CORNER_PREFERENCE
Use con DwmSetWindowAttribute. Especifica la preferencia de esquina redondeada para una ventana. El parámetro pvAttribute apunta a un valor de tipo DWM_WINDOW_CORNER_PREFERENCE.

Este valor se admite a partir de Windows 11 compilación 22000.
DWMWA_BORDER_COLOR
Use con DwmSetWindowAttribute. Especifica el color del borde de la ventana. El parámetro pvAttribute apunta a un valor de tipo COLORREF. La aplicación es responsable de cambiar el color del borde según los cambios de estado, como un cambio en la activación de la ventana.

Al especificar DWMWA_COLOR_NONE (valor 0xFFFFFFFE) para el color se suprimirá el dibujo del borde de la ventana. Esto permite tener una ventana redondeada sin borde.

Al especificar DWMWA_COLOR_DEFAULT (valor 0xFFFFFFFF) para el color, se restablecerá la ventana al uso del comportamiento predeterminado del sistema para el color del borde.

Este valor se admite a partir de Windows 11 compilación 22000.
DWMWA_CAPTION_COLOR
Use con DwmSetWindowAttribute. Especifica el color del subtítulo. El parámetro pvAttribute apunta a un valor de tipo COLORREF.

Al especificar DWMWA_COLOR_DEFAULT (valor 0xFFFFFFFF) para el color, se restablecerá la ventana al uso del comportamiento predeterminado del sistema para el color de subtítulo.

Este valor se admite a partir de Windows 11 compilación 22000.
DWMWA_TEXT_COLOR
Use con DwmSetWindowAttribute. Especifica el color del texto subtítulo. El parámetro pvAttribute apunta a un valor de tipo COLORREF.

Al especificar DWMWA_COLOR_DEFAULT (valor 0xFFFFFFFF) para el color, se restablecerá la ventana al uso del comportamiento predeterminado del sistema para el color de texto de subtítulo.

Este valor se admite a partir de Windows 11 compilación 22000.
DWMWA_VISIBLE_FRAME_BORDER_THICKNESS
Use con DwmGetWindowAttribute. Recupera el ancho del borde exterior que el DWM dibujaría alrededor de esta ventana. El valor puede variar en función del PPP de la ventana. El parámetro pvAttribute apunta a un valor de tipo UINT.

Este valor se admite a partir de Windows 11 compilación 22000.
DWMWA_SYSTEMBACKDROP_TYPE
Use con DwmGetWindowAttribute o DwmSetWindowAttribute. Recupera o especifica el material de fondo dibujado por el sistema de una ventana, incluido detrás del área que no es de cliente. El parámetro pvAttribute apunta a un valor de tipo DWM_SYSTEMBACKDROP_TYPE.

Este valor se admite a partir de Windows 11 compilación 22621.
DWMWA_LAST
Valor DWMWINDOWATTRIBUTE máximo reconocido, que se usa con fines de validación.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado dwmapi.h

Consulte también