Compartir a través de

Enumeración DWMWINDOWATTRIBUTE (dwmapi.h)

  • Artículo

Opciones usadas por las DwmGetWindowAttribute y DwmSetWindowAttribute funciones.

Sintaxis

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

IMPORTANTE

El valor de DWMWA_NCRENDERING_ENABLED es 1.

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

Use con DwmGetWindowAttribute. Detecta si la representación no 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 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 sea 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 sea 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 de título en el espacio relativo a la ventana. El valor recuperado es de tipo RECT. Si la ventana está minimizada o no es visible para el usuario, el valor del RECT recuperado no está definido. Debe comprobar si la rect recuperada contiene un límite con el que puede trabajar y, si no, 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 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 se cambia durante la vigencia 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 miniatura emblemática o ver la representació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 se 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 miniatura emblemática o una representación de 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 puntero sobre la miniatura de la ventana en la barra de tareas. Si se establece este atributo, mantener el puntero del mouse sobre la miniatura de la ventana descarta la vista previa (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 permitirla.

Windows Vista y versiones anteriores: Este valor no se admite.
DWMWA_EXCLUDED_FROM_PEEK
Use con DwmSetWindowAttribute. Impide que una ventana se desvanece a una hoja de vidrio cuando se invoca la vista. El parámetro pvAttribute apunta a un valor de tipo BOOL. TRUE para evitar que la ventana se desvanece durante la inspección 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.

Usar 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 estaba ocultada por su aplicación propietaria.

DWM_CLOAKED_SHELL (0x00000002 de valor). La ventana estaba 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 ninguna actualización activa adicional en la imagen en miniatura para que coincida 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 Windows::UI::Composition API puede generar efectos de transparencia mediante el pincel de telón 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 deshabilitarlo.

Este valor es compatible a partir de Windows 11 Build 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 usar siempre el modo claro.

Este valor es compatible a partir de Windows 11 Build 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 es compatible a partir de Windows 11 Build 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 es compatible a partir de Windows 11 Build 22000.
DWMWA_CAPTION_COLOR
Use con DwmSetWindowAttribute. Especifica el color del tí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 del título.

Este valor es compatible a partir de Windows 11 Build 22000.
DWMWA_TEXT_COLOR
Use con DwmSetWindowAttribute. Especifica el color del texto del tí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 del texto del título.

Este valor es compatible a partir de Windows 11 Build 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 es compatible a partir de Windows 11 Build 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 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 máximo reconocido DWMWINDOWATTRIBUTE, utilizado con fines de validación.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2008 [solo aplicaciones de escritorio]
encabezado de dwmapi.h

Consulte también