UIElement.Opacity UIElement.Opacity UIElement.Opacity UIElement.Opacity Property

Définition

Obtient ou définit le facteur d’opacité appliqué au UIElement entier quand il est affiché dans l’interface utilisateur (UI)user interface (UI).Gets or sets the opacity factor applied to the entire UIElement when it is rendered in the interface utilisateur (UI)user interface (UI). Il s’agit d’une propriété de dépendance.This is a dependency property.

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; }
member this.Opacity : double with get, set
Public Property Opacity As Double

Valeur de propriété

Facteur d’opacité.The opacity factor. L’opacité par défaut est 1,0.Default opacity is 1.0. Les valeurs attendues sont comprises entre 0,0 et 1,0.Expected values are between 0.0 and 1.0.

Remarques

La valeur par 1,0 défaut est la valeur par défaut fournie par les métadonnées initiales de cette propriété de dépendance sur la UIElement classe.The 1.0 default value is the default provided by the initial metadata of this dependency property on the UIElement class. Autres classes dérivées peuvent potentiellement modifier cette valeur par défaut en substituant les métadonnées à partir de son constructeur de classe.Other derived classes may potentially change this default value by overriding the metadata from within their class constructor.

La valeur de Opacity n’est pas appliqué à la disposition réelle, sauf si l’élément est également visible (IsVisible est true).The value of Opacity won't be applied to actual layout unless the element is also visible (IsVisible is true).

Opacity est appliqué à partir d’éléments parents sur vers le bas de l’arborescence d’éléments pour les éléments enfants, mais les effets visibles de l’opacité imbriquée paramètres ne sont pas indiqués dans la valeur de propriété de chaque élément enfant.Opacity is applied from parent elements on down the element tree to child elements, but the visible effects of the nested opacity settings aren't indicated in the property value of individual child elements. Par exemple, si une liste a une opacité de 50 % (0,5) et de ses éléments a une opacité de 20 % (0,2), l’opacité visible pour cet élément de liste est restituée comme s’il s’agissait de 10 % (0,1), mais la valeur de propriété de l’élément de liste Opacity propriété serait toujours 0,2 lorsqu’il est interrogé.For instance, if a list has a 50% (0.5) opacity and one of its list items has its own opacity set to 20% (0.2), the net visible opacity for that list item will be rendered as if it were 10% (0.1), but the property value of the list item Opacity property would still be 0.2 when queried.

Même si l’opacité déclarée ou évaluée est 0, un élément toujours participe aux commandes et les événements d’entrée et potentiellement peut recevoir le focus.Even if the declared or evaluated opacity is 0, an element still participates in input events and commands, and is potentially focusable. Cet aspect peut être utile, par exemple, vous pouvez utiliser un objet d’opacité nulle (par exemple, une forme) pour le masquage des objets sous-jacents avec les éléments transparents.This aspect can be useful, for instance you can use an opacity-zero object (such as a shape) for masking underlying objects with transparent elements. L’objet d’opacité nulle peut alors gérer l’événement d’entrée de traitement pour une zone sous-jacente.The opacity-zero object can then handle all the input event processing for an underlying area. Toutefois, le Background ou Fill de l’objet ou de la forme doit être définie 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çus.However, the Background or Fill of the object or shape should be set to a value, even if it is Transparent, otherwise hit testing is not enabled, and no events are received.

Informations sur les propriétés de dépendanceDependency Property Information

Champ d’identificateurIdentifier field OpacityProperty
La valeur des propriétés de métadonnées trueMetadata properties set to true Aucun.None

S’applique à

Voir aussi