IDCompositionVisual2 ::SetOpacityMode, méthode (dcomp.h)

Définit le mode d’opacité pour ce visuel.

Syntaxe

HRESULT SetOpacityMode(
  [in] DCOMPOSITION_OPACITY_MODE mode
);

Paramètres

[in] mode

Mode d’opacité à utiliser lors de la composition du visuel à l’écran.

Valeur retournée

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur DirectComposition .

Remarques

Le mode opacité affecte la façon dont la propriété Opacity d’un objet de groupe d’effets affecte la composition d’une sous-arborescence visuelle. DirectComposition prend en charge deux modes d’opacité : Calque et Multiplier. En mode Couche, chaque sous-arborescence visuelle peut être vue logiquement comme une bitmap qui contient la rastérisation opaque de cette sous-arborescence entière, à laquelle la valeur d’opacité est ensuite appliquée. De cette façon, les surfaces opaques qui se chevauchent se fondent avec l’arrière-plan de la sous-arborescence, mais pas les unes avec les autres. En revanche, en mode Multiplier, l’opacité est appliquée individuellement à chaque surface telle qu’elle est composée, de sorte que les surfaces se fondent les unes avec les autres. Le mode Multiplier est plus rapide que le mode Couche et toujours préféré si l’arborescence visuelle contient un contenu qui ne se chevauche pas entièrement. Toutefois, le mode Multiplier peut produire des résultats visuels indésirables pour les éléments qui se chevauchent.

Par défaut, un visuel hérite du mode d’opacité de son visuel parent, qui peut hériter du mode d’opacité de son visuel parent, et ainsi de suite. Un visuel utilise le mode DCOMPOSITION_OPACITY_MODE_LAYER si cette méthode n’est jamais appelée pour le visuel ou si cette méthode est appelée avec DCOMPOSITION_OPACITY_MODE_INHERIT. Si aucun visuel ne définit le mode d’opacité, la valeur par défaut de l’arborescence visuelle entière est DCOMPOSITION_OPACITY_MODE_LAYER.

Si le paramètre opacityMode est autre que DCOMPOSITION_OPACITY_MODE_INHERIT, les surfaces de ce visuel sont composées avec le mode d’opacité spécifié. En outre, ce mode d’opacité devient la nouvelle valeur par défaut pour les enfants du visuel actuel. Autrement dit, si le mode d’opacité des enfants de ce visuel est inchangé ou explicitement défini sur DCOMPOSITION_OPACITY_MODE_INHERIT, les surfaces que les visuels enfants sont composées à l’aide du mode d’opacité de ce visuel.

Configuration requise

Voir aussi

IDCompositionEffectGroup ::SetOpacity

IDCompositionVisual2