Método IDCompositionVisual2::SetOpacityMode (dcomp.h)
Establece el modo de opacidad para este objeto visual.
Sintaxis
HRESULT SetOpacityMode(
[in] DCOMPOSITION_OPACITY_MODE mode
);
Parámetros
[in] mode
Modo de opacidad que se va a usar al redactar el objeto visual en la pantalla.
Valor devuelto
Si la función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT. Consulte Códigos de error de DirectComposition para obtener una lista de códigos de error.
Comentarios
El modo de opacidad afecta a cómo afecta la propiedad Opacity de un objeto de grupo de efectos a la composición de un subárbol visual. DirectComposition admite dos modos de opacidad: Layer y Multiply. En el modo capa, cada subárbol visual se puede ver lógicamente como un mapa de bits que contiene la rasterización opaca de ese subárbol completo, al que se aplica el valor de opacidad. De esta manera, las superficies opacas superpuestas se combinan con el fondo del subárbol, pero no entre sí. En cambio, en el modo Multiplicar, la opacidad se aplica individualmente a cada superficie a medida que se compone, por lo que las superficies se combinan entre sí. El modo de multiplicación es más rápido que el modo de capa y siempre se prefiere si el árbol visual contiene contenido completamente no superpuesto. Sin embargo, el modo Multiplicar puede producir resultados visuales no deseados para elementos superpuestos.
De forma predeterminada, un objeto visual hereda el modo de opacidad de su objeto visual primario, que puede heredar el modo de opacidad de su objeto visual primario, etc. Un objeto visual usa el modo DCOMPOSITION_OPACITY_MODE_LAYER si nunca se llama a este método para el objeto visual o si se llama a este método con DCOMPOSITION_OPACITY_MODE_INHERIT. Si ningún objeto visual establece el modo de opacidad, el valor predeterminado de todo el árbol visual es DCOMPOSITION_OPACITY_MODE_LAYER.
Si el parámetro opacityMode es distinto de DCOMPOSITION_OPACITY_MODE_INHERIT, las superficies de este objeto visual se componen con el modo de opacidad especificado. Además, este modo de opacidad se convierte en el nuevo valor predeterminado para los elementos secundarios del objeto visual actual. Es decir, si el modo de opacidad de los elementos secundarios de este objeto visual no cambia o se establece explícitamente en DCOMPOSITION_OPACITY_MODE_INHERIT, las superficies que los objetos visuales secundarios se componen mediante el modo de opacidad de este objeto visual.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8.1 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | dcomp.h |
| Library | Dcomp.lib |
| Archivo DLL | Dcomp.dll |