Freigeben über


UIElement.Opacity Eigenschaft

Definition

Ruft den Deckkraftfaktor ab, der auf das gesamte UIElement angewendet wird, wenn er auf der Benutzeroberfläche gerendert wird, oder legt diesen fest. Hierbei handelt es sich um eine Abhängigkeitseigenschaft.

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

Eigenschaftswert

Der Deckkraftfaktor. Die Standarddeckkraft ist 1,0. Erwartete Werte liegen zwischen 0,0 und 1,0.

Attribute

Hinweise

Der Standardwert 1.0 ist der Standardwert, der von den anfänglichen Metadaten dieser Abhängigkeitseigenschaft für die UIElement -Klasse bereitgestellt wird. Andere abgeleitete Klassen können diesen Standardwert möglicherweise ändern, indem sie die Metadaten aus ihrem Klassenkonstruktor außer Kraft setzen.

Der Wert von Opacity wird nicht auf das tatsächliche Layout angewendet, es sei denn, das Element ist auch sichtbar (IsVisible ist true).

Opacity wird von übergeordneten Elementen in der Elementstruktur auf untergeordnete Elemente angewendet, aber die sichtbaren Auswirkungen der geschachtelten Deckkrafteinstellungen werden im Eigenschaftswert einzelner untergeordneter Elemente nicht angegeben. Wenn eine Liste beispielsweise eine Deckkraft von 50 % (0,5) aufweist und eines ihrer Listenelemente seine eigene Deckkraft auf 20 % (0,2) festgelegt hat, wird die sichtbare Nettodurchlässigkeit für dieses Listenelement so gerendert, als ob es 10 % (0,1) wäre, aber der Eigenschaftswert der Listenelementeigenschaft Opacity würde bei Abfragen immer noch 0,2 betragen.

Selbst wenn die deklarierte oder ausgewertete Deckkraft 0 ist, nimmt ein Element weiterhin an Eingabeereignissen und -befehlen teil und ist potenziell fokussierbar. Dieser Aspekt kann nützlich sein, beispielsweise können Sie ein Opacity-Zero-Objekt (z. B. eine Form) verwenden, um zugrunde liegende Objekte mit transparenten Elementen zu maskieren. Das Objekt opacity-zero kann dann die gesamte Eingabeereignisverarbeitung für einen zugrunde liegenden Bereich verarbeiten. Das Background oder Fill des Objekts oder der Form sollte jedoch auf einen Wert festgelegt werden, auch wenn dies der Wert ist Transparent. Andernfalls wird der Treffertest nicht aktiviert, und es werden keine Ereignisse empfangen.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld OpacityProperty
Metadateneigenschaften auf true festgelegt Keine

Gilt für:

Weitere Informationen