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

Definition

Ruft den Deckkraftfaktor ab oder legt ihn fest, der auf das gesamte UIElement angewendet wird, wenn es in der Benutzeroberfläche (User Interface, UI)user interface (UI) gerendert wird.Gets or sets the opacity factor applied to the entire UIElement when it is rendered in the Benutzeroberfläche (User Interface, UI)user interface (UI). Hierbei handelt es sich um eine Abhängigkeitseigenschaft.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

Eigenschaftswert

Der Deckkraftfaktor.The opacity factor. Die Standarddeckkraft ist 1,0.Default opacity is 1.0. Erwartete Werte liegen zwischen 0,0 und 1,0.Expected values are between 0.0 and 1.0.

Hinweise

Der Standardwert 1,0 ist der Standardwert, der von den anfänglichen Metadaten dieser Abhängigkeits Eigenschaft UIElement für die-Klasse bereitgestellt wird.The 1.0 default value is the default provided by the initial metadata of this dependency property on the UIElement class. Andere abgeleitete Klassen können diesen Standardwert potenziell ändern, indem Sie die Metadaten innerhalb Ihres Klassenkonstruktors überschreiben.Other derived classes may potentially change this default value by overriding the metadata from within their class constructor.

Der Wert von Opacity wird nicht auf das tatsächliche Layout angewendet, es sei denn, dasIsVisible - trueElement ist ebenfalls sichtbar (ist).The value of Opacity won't be applied to actual layout unless the element is also visible (IsVisible is true).

Opacitywird von übergeordneten Elementen auf der Elementstruktur auf untergeordnete Elemente angewendet, aber die sichtbaren Auswirkungen der geschiesteten Deckkraft Einstellungen werden im Eigenschafts Wert einzelner untergeordneter Elemente nicht angegeben.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. Wenn eine Liste beispielsweise eine Deckkraft von 50% (0,5) aufweist und für eines ihrer Listenelemente eine eigene Deckkraft auf 20% (0,2) festgelegt ist, wird die sichtbare Deckkraft für das Listenelement so gerendert, als wäre es 10% (0,1), aber der Eigenschafts Wert der Opacity List Item-Eigenschaft wäre weiterhin 0,2, wenn abgefragt wird.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.

Selbst wenn die deklarierte oder ausgewertete Deckkraft gleich 0 ist, ist ein Element weiterhin an Eingabe Ereignissen und Befehlen beteiligt und kann möglicherweise als schwer zu verwendbar sein.Even if the declared or evaluated opacity is 0, an element still participates in input events and commands, and is potentially focusable. Dieser Aspekt kann nützlich sein. Sie können z. b. ein Opacity-Zero-Objekt (z. b. eine Form) zum Maskieren von zugrunde liegenden Objekten mit transparenten Elementen verwenden.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. Das Opacity-Zero-Objekt kann dann die gesamte Eingabe Ereignisverarbeitung für einen zugrunde liegenden Bereich verarbeiten.The opacity-zero object can then handle all the input event processing for an underlying area. Allerdings sollte Background das Fill oder des Objekts oder der Form auf einen Wert festgelegt werden, selbst wenn es Transparentist. andernfalls werden Treffer Tests nicht aktiviert, und es werden keine Ereignisse empfangen.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.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field OpacityProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true KeineNone

Gilt für:

Siehe auch