UIElement.Visibility Proprietà

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml

Ottiene o imposta la visibilità di un UIElement. Oggetto UIElement che non è visibile non viene eseguito il rendering e non comunica le dimensioni desiderate per il 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"/>

Valore della proprietà

Visibility

Valore dell'enumerazione. Il valore predefinito è Visible.

Esempio

Visibilità in uno stato visivo Come parte della definizione degli stati visivi per un controllo, a volte si vuole modificare lo Visibility stato di un oggetto in Collapsed. Gli stati visivi si basano sulle animazioni. Il tipo di valore della Visibility proprietà è Visibility, un'enumerazione. Per animare i valori che sono enumerazioni, è necessario usare un oggetto DiscreteObjectKeyFrame. Questa tecnica viene usata anche per i valori booleani. Questo esempio XAML mostra uno stato visivo che usa DiscreteObjectKeyFrame per modificare la visibilità.

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

Commenti

Un elemento dell'interfaccia utente con Visibility valori uguali Collapsed viene ancora caricato insieme al resto del codice XAML in una pagina ed esiste nell'albero degli oggetti di runtime.

Un elemento con valori uguali Collapsed non ha Visibility posizione nell'interfaccia utente e non partecipa a input o hit test. Non si trovano anche in una sequenza di schede e non possono essere incentrati, nemmeno a livello di codice. Se si desidera ancora l'input, lo stato attivo o il test di hit, anziché impostare Visibilità usare una Opacità zero.

BooleanToVisibilityConverter

Uno scenario comune nelle app che usano dati da un'origine dati consiste nell'identificare una proprietà dei dati o del modello di visualizzazione per i dati che controllano se i dati devono essere visualizzati. Uno scenario correlato sta scrivendo un modello che può modificare l'oggetto Visibility di una parte di controllo in base a una proprietà booleana del controllo padre o di un'altra parte. Per semplificare la definizione di questo comportamento come parte di un binding, alcuni dei modelli di progetto predefiniti includono una BooleanToVisibilityConverter classe helper nella cartella Common. Per altre informazioni su come usare un convertitore di valori per un data binding, vedere IValueConverter.

Vedi anche

• Definire layout con XAML