UIElement.Opacity Propriété

Définition

Espace de noms:

System.Windows

Assembly:

PresentationCore.dll

Obtient ou définit le facteur d’opacité appliqué à l’ensemble UIElement lorsqu’il est rendu dans l’interface utilisateur . Il s’agit d’une propriété de dépendance.

public:
 property double Opacity { double get(); void set(double value); };

[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public double Opacity { get; set; }

[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
member this.Opacity : double with get, set

Public Property Opacity As Double

Valeur de propriété

Double

Facteur d’opacité. L’opacité par défaut est 1,0. Les valeurs attendues sont comprises entre 0,0 et 1,0.

Attributs

LocalizabilityAttribute

Remarques

La valeur par défaut 1.0 est la valeur par défaut fournie par les métadonnées initiales de cette propriété de dépendance sur la UIElement classe . D’autres classes dérivées peuvent potentiellement modifier cette valeur par défaut en remplaçant les métadonnées à partir de leur constructeur de classe.

La valeur de Opacity ne sera pas appliquée à la disposition réelle, sauf si l’élément est également visible (IsVisible est true).

Opacity est appliqué à partir d’éléments parents sur l’arborescence d’éléments vers le bas aux éléments enfants, mais les effets visibles des paramètres d’opacité imbriqués ne sont pas indiqués dans la valeur de propriété des éléments enfants individuels. Par exemple, si une liste a une opacité de 50 % (0,5) et que l’un de ses éléments de liste a sa propre opacité définie sur 20 % (0,2), l’opacité nette visible pour cet élément de liste est affichée comme s’il s’agissait de 10 % (0,1), mais la valeur de propriété de la propriété d’élément Opacity de liste est toujours 0,2 quand elle est interrogée.

Même si l’opacité déclarée ou évaluée est égale à 0, un élément participe toujours aux événements et aux commandes d’entrée et peut être mis au point. Cet aspect peut être utile, par exemple, vous pouvez utiliser un objet opacité zéro (tel qu’une forme) pour masquer les objets sous-jacents avec des éléments transparents. L’objet opacity-zero peut ensuite gérer tout le traitement des événements d’entrée pour une zone sous-jacente. Toutefois, ou BackgroundFill de l’objet ou de la forme doit être défini sur une valeur, même si elle est Transparent, sinon le test de positionnement n’est pas activé et aucun événement n’est reçu.

Informations sur les propriétés de dépendance

Champ Identificateur	OpacityProperty
Propriétés de métadonnées définies sur true	Aucun

Voir aussi

• OpacityMask