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

Die 1,0 wird standardmäßig mit den anfänglichen Metadaten dieser Abhängigkeitseigenschaft auf die UIElement Klasse.The 1.0 default value is the default provided by the initial metadata of this dependency property on the UIElement class. Andere abgeleiteten Klassen können potenziell diesen Standardwert ändern, werden die Metadaten aus ihrem Klassenkonstruktor.Other derived classes may potentially change this default value by overriding the metadata from within their class constructor.

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

Opacity wird von übergeordneten Elementen auf angewendet in der Elementstruktur auf untergeordnete Elemente, aber die sichtbaren Auswirkungen der geschachtelten Deckkraft, die Einstellungen in den Wert der Eigenschaft der einzelnen untergeordneten Elemente angegeben sind nicht.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. Z. B. wenn eine Liste eine Durchlässigkeit von 50 % (0,5 hat) und eines der Listenelemente aus der die Durchlässigkeit von 20 % (0,2) festgelegt ist, die tatsächliche Durchlässigkeit für dieses Listenelement wird gerendert als handele es sich um 10 % (0,1), aber der Wert der Eigenschaft des Listenelements Opacity Eigenschaft würde weiterhin sein. 0,2, wenn die Abfrage.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.

Auch wenn die deklarierte oder ausgewertete Deckkraft 0 ist, ein Element noch beteiligt Eingabeereignisse und Befehle und ist potenziell den Fokus erhalten.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, z. B. Sie eine Deckkraft NULL-Objekt (z. B. eine Form) zum Maskieren die zugrunde liegenden Objekte mit transparente Elemente verwenden können.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. Die Deckkraft NULL-Objekt kann dann alle das Eingabeereignis, Verarbeitung für einen zugrunde liegenden Bereich behandeln.The opacity-zero object can then handle all the input event processing for an underlying area. Allerdings die Background oder Fill des Objekts oder der Form sollte festgelegt werden auf einen Wert, selbst wenn sie ist TransparentTreffertests andernfalls nicht aktiviert ist und keine Ereignisse empfangen werden.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

Feld "ID"Identifier field OpacityProperty
Legen Sie auf der Metadaten-Eigenschaften trueMetadata properties set to true KeinerNone

Gilt für:

Siehe auch