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

Definizione

Ottiene o imposta il fattore di opacità applicato all'intero oggetto UIElement quando ne viene eseguito il rendering nell'oggetto interfaccia utenteuser interface (UI).Gets or sets the opacity factor applied to the entire UIElement when it is rendered in the interfaccia utenteuser interface (UI). Si tratta di una proprietà di dipendenza.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

Valore della proprietà

Fattore di opacità.The opacity factor. L'opacità predefinita è 1,0.Default opacity is 1.0. I valori previsti sono compresi tra 0,0 e 1,0.Expected values are between 0.0 and 1.0.

Commenti

Il valore predefinito 1,0 è l'impostazione predefinita fornita dai metadati iniziali della proprietà di dipendenza nella UIElement classe.The 1.0 default value is the default provided by the initial metadata of this dependency property on the UIElement class. Altre classi derivate possono potenzialmente modificare questo valore predefinito eseguendo l'override dei metadati dall'interno del relativo costruttore di classe.Other derived classes may potentially change this default value by overriding the metadata from within their class constructor.

Il valore di Opacity non verrà applicato al layout effettivo a meno che anche l'elemento non siaIsVisible visibile true(is).The value of Opacity won't be applied to actual layout unless the element is also visible (IsVisible is true).

Opacityviene applicato dagli elementi padre sull'albero degli elementi agli elementi figlio, ma gli effetti visibili delle impostazioni di opacità nidificata non sono indicati nel valore della proprietà dei singoli elementi figlio.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. Ad esempio, se un elenco ha un'opacità 50% (0,5) e uno degli elementi dell'elenco ha una propria opacità impostata sul 20% (0,2), verrà eseguito il rendering dell'opacità visibile netta per tale elemento dell'elenco come se fosse 10% (0,1), ma il valore Opacity della proprietà della proprietà dell'elemento dell'elenco sarebbe ancora 0,2 quando viene eseguita una query.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.

Anche se l'opacità dichiarata o valutata è 0, un elemento continua a partecipare a eventi e comandi di input ed è potenzialmente attivabile.Even if the declared or evaluated opacity is 0, an element still participates in input events and commands, and is potentially focusable. Questo aspetto può essere utile, ad esempio, è possibile usare un oggetto Opacity-zero, ad esempio una forma, per mascherare oggetti sottostanti con elementi trasparenti.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'oggetto Opacity-zero può quindi gestire tutte le operazioni di elaborazione degli eventi di input per un'area sottostante.The opacity-zero object can then handle all the input event processing for an underlying area. Tuttavia, l' Background oggetto Fill o dell'oggetto o della forma deve essere impostato su un valore Transparent, anche se è, in caso contrario l'hit testing non è abilitato e non viene ricevuto alcun evento.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.

Informazioni proprietà di dipendenzaDependency Property Information

Campo identificatoreIdentifier field OpacityProperty
Proprietà dei metadati impostate sutrueMetadata properties set to true nessunoNone

Si applica a

Vedi anche