UIElement.Visibility Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen der Sichtbarkeit eines UIElements. Ein UIElement nicht sichtbarer Wert wird nicht gerendert und kommuniziert nicht seine gewünschte Größe mit dem 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
Ein Wert der Aufzählung. 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 Collapsedin ändern. Visuelle Zustände basieren auf Animationen. Der Eigenschaftswerttyp ist VisibilityVisibility, eine Aufzählung. Zum Animieren von Werten, die Enumerationen sind, müssen Sie einen DiscreteObjectKeyFrame verwenden. (Sie verwenden diese Technik auch für boolesche Werte). Dieses XAML-Beispiel zeigt einen visuellen Zustand, der zum Ändern der Sichtbarkeit verwendet DiscreteObjectKeyFrame wird.
<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 ist VisibilityCollapsed , wird weiterhin zusammen mit dem rest des XAML-Codes auf einer Seite geladen und in der Laufzeitobjektstruktur vorhanden.
Ein Element, das gleich istCollapsed, hat Visibility keine Position in der Benutzeroberfläche und nimmt nicht an Eingabe- oder Treffertests teil. Sie befinden sich auch nicht in einer Tabstoppsequenz und können nicht programmgesteuert fokussiert werden. Wenn Sie weiterhin Eingaben, Fokus- oder Treffertests benötigen, anstatt die Sichtbarkeit festzulegen, verwenden Sie eine Nulldurchsichtigkeit.
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 den Visibility Teil eines Steuerelements 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 "Allgemein". Weitere Informationen zur Verwendung eines Wertkonverters für eine Datenbindung finden Sie unter IValueConverter.