UIElement.Visibility Eigenschaft

Definition

Ruft die Benutzeroberfläche (User Interface, UI)user interface (UI)-Sichtbarkeit dieses Elements ab oder legt sie fest.Gets or sets the Benutzeroberfläche (User Interface, UI)user interface (UI) visibility of this element. Hierbei handelt es sich um eine Abhängigkeitseigenschaft.This is a dependency property.

public:
 property System::Windows::Visibility Visibility { System::Windows::Visibility get(); void set(System::Windows::Visibility value); };
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public System.Windows.Visibility Visibility { get; set; }
member this.Visibility : System.Windows.Visibility with get, set
Public Property Visibility As Visibility

Eigenschaftswert

Ein Wert aus der Enumeration.A value of the enumeration. Der Standardwert ist Visiblesein.The default value is Visible.

Attribute

Beispiele

Im folgenden Beispiel wird ein Handler implementiert, der auf zwei verschiedene benannte Schaltflächen verweist, die in der Benutzeroberfläche als gegenseitig ausschließliches paar gedacht sind.The following example implements a handler that references two different named buttons that are intended to be a mutually exclusive pair in the user interface. Vor der Ausführung der eigentlichen Programmlogik, die der Schaltfläche zugeordnet ist, wird die Schaltfläche selbst auf Visibility.Hiddenfestgelegt, und die andere Schaltfläche im Paar ist auf Visibility.Visiblefestgelegt.Prior to running the actual program logic associated with the button, the button itself is set to be Visibility.Hidden, and the other button in the pair is set to Visibility.Visible.

private void PlayMedia(object sender, MouseButtonEventArgs args)
{
    pauseBTN.Visibility = Visibility.Visible;
    playBTN.Visibility = Visibility.Collapsed;

    media.SpeedRatio = 1.0;
    media.Play();
}
Private Sub PlayMedia(ByVal sender As Object, ByVal args As MouseButtonEventArgs)
    pauseBTN.Visibility = System.Windows.Visibility.Visible
    playBTN.Visibility = System.Windows.Visibility.Collapsed

    media.SpeedRatio = 1.0
    media.Play()

End Sub

Hinweise

Wenn Sie diese Eigenschaft festlegen, wirkt sich dies auf den Wert von IsVisibleaus, der wiederum das IsVisibleChanged Ereignis hervorrufen kann.Setting this property affects the value of IsVisible, which in turn may raise the IsVisibleChanged event. IsVisible hat jedoch andere Faktoren, die dies beeinflussen, z. a. die Sichtbarkeitseinstellungen von übergeordneten Elementen, die Sie enthalten.However, IsVisible has other factors that influence it, for instance the visibility settings of parents that contain it.

Elemente, bei denen Visibility nicht Visible, werden nicht an Eingabe Ereignissen (oder Befehlen) beteiligt, beeinflussen weder das Measure noch die Anordnungs Überläufen des Layouts, sind nicht in einer Tabstopp Sequenz und werden nicht in Treffer Tests gemeldet.Elements where Visibility is not Visible do not participate in input events (or commands), do not influence either the Measure or Arrange passes of layout, are not in a tab sequence, and will not be reported in hit testing.

Wenn Sie von Window oder seinen abgeleiteten Klassen geerbt wird, definiert Window den Standardwert dieser Eigenschaft neu, damit er Collapsedwird.When inherited by Window or its derived classes, Window redefines the default value of this property to be Collapsed. Dies hat den Effekt, dass der Mess Pass des Layouts nicht auf einem anfänglich erstellten Windowausgeführt wird, und RenderSize gibt (0,0) zurück.This has the effect of not running the Measure pass of layout on an initially created Window, and RenderSize returns (0,0). Ausführliche Informationen finden Sie unter Window.For details, see Window. Popup definiert auch den Standardwert neu, der Collapsedwerden soll, mit ähnlichem resultierenden Verhalten für Popup und seine abgeleiteten Klassen.Popup also redefines the default value to be Collapsed, with similar resulting behavior for Popup and its derived classes.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

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

Gilt für:

Siehe auch