UIElement.Visibility Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml

Ruft die Sichtbarkeit eines UIElements ab oder legt diese fest. Ein UIElement nicht sichtbarer wird nicht gerendert und kommuniziert nicht die gewünschte Größe an das Layout.

public:
 property Visibility Visibility { Visibility get(); void set(Visibility value); };

Visibility Visibility();

void Visibility(Visibility value);

public Visibility Visibility { get; set; }

var visibility = uIElement.visibility;
uIElement.visibility = visibility;

Public Property Visibility As Visibility

<uiElement Visibility="Visible"/>
-or-
<uiElement Visibility="Collapsed"/>

Eigenschaftswert

Visibility

Ein Wert aus der Enumeration. Der Standardwert ist Visible.

Beispiele

Sichtbarkeit in einem visuellen Zustand Im Rahmen der Definition visueller Zustände für ein Steuerelement möchten Sie manchmal den Visibility Zustand eines Objekts in Collapsedändern. Visuelle Zustände basieren auf Animationen. Der Eigenschaftswerttyp von Visibility ist Visibility, eine Enumeration. Zum Animieren von Werten, die Enumerationen sind, müssen Sie ein DiscreteObjectKeyFrame verwenden. (Sie verwenden diese Technik auch für boolesche Werte. Dieses XAML-Beispiel zeigt einen visuellen Zustand, der DiscreteObjectKeyFrame verwendet, um die Sichtbarkeit zu ändern.

<VisualState x:Name="Focused">
  <Storyboard>
    <ObjectAnimationUsingKeyFrames Storyboard.TargetName="FocusVisualElement" Storyboard.TargetProperty="Visibility" Duration="0">
      <DiscreteObjectKeyFrame KeyTime="0" Value="Visible"/>
    </ObjectAnimationUsingKeyFrames>
  </Storyboard>
</VisualState>

Hinweise

Ein UI-Element, das gleich Collapsed ist, Visibility wird weiterhin zusammen mit dem Rest des XAML auf einer Seite geladen und ist in der Laufzeitobjektstruktur vorhanden.

Ein Element, das gleich Collapsed istVisibility, hat keinen Speicherort auf der Benutzeroberfläche und nimmt nicht an Eingabe- oder Treffertests teil. Sie befinden sich auch nicht in einer Registerkartensequenz und können nicht fokussiert werden, nicht einmal programmgesteuert. Wenn Sie weiterhin Eingabe-, Fokus- oder Treffertests verwenden möchten, verwenden Sie anstelle von Sichtbarkeit eine 0(0) Deckkraft.

Booleantovisibilityconverter

Ein häufiges Szenario in Apps, die Daten aus einer Datenquelle verwenden, besteht darin, eine Eigenschaft der Daten oder das Ansichtsmodell für die Daten zu identifizieren, die steuern, ob die Daten angezeigt werden sollen. Ein verwandtes Szenario ist das Schreiben einer Vorlage, die die Visibility eines Steuerelementteils basierend auf einer booleschen Eigenschaft des übergeordneten Steuerelements oder eines anderen Teils ändern kann. Um die Definition dieses Verhaltens als Teil einer Bindung zu vereinfachen, enthalten einige der Standardprojektvorlagen eine BooleanToVisibilityConverter Hilfsklasse im Ordner Common. Weitere Informationen zur Verwendung eines Wertkonverters für eine Datenbindung finden Sie unter IValueConverter.

Weitere Informationen

• Definieren von Layouts mit XAML