UIElement.Visibility Eigenschaft

Definition

Namespace:

Windows.UI.Xaml

Ruft die Sichtbarkeit eines UIElements ab oder legt diese fest. Ein UIElement , das nicht sichtbar ist, 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 Beim Definieren visueller Zustände für ein Steuerelement möchten Sie manchmal den Sichtbarkeitszustand eines Objekts in Reduziert ä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 dieses Verfahren 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 über "Visibility" gleich "Collapsed " verfügt, wird weiterhin zusammen mit dem Rest des XAML-Elements auf einer Seite geladen und ist in der Laufzeitobjektstruktur vorhanden.

Ein Element, das über Visibility gleich "Collapsed " verfügt über 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 möchten, anstatt Sichtbarkeit festzulegen, verwenden Sie eine 0Opacity.

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 Sichtbarkeit eines Steuerelementteils basierend auf einer booleschen Eigenschaft des übergeordneten Steuerelements oder eines anderen Teils ändern kann. Um das Definieren 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