UIElement.Visibility Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml

Obtient ou définit la visibilité d’un UIElement. Un UIElement qui n’est pas visible n’est pas rendu et ne communique pas sa taille souhaitée à la disposition.

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"/>

Valeur de propriété

Visibility

Valeur de l’énumération. La valeur par défaut est Visible.

Exemples

Visibilité dans un état visuel Dans le cadre de la définition des états visuels d’un contrôle, vous souhaiterez parfois modifier l’état Visibility d’un objet en Collapsed. Les états visuels s’appuient sur des animations. Le type de valeur de propriété de Visibility est Visibility, une énumération. Pour animer des valeurs qui sont des énumérations, vous devez utiliser un DiscreteObjectKeyFrame. (Vous utilisez également cette technique pour les valeurs booléennes). Cet exemple XAML montre un état visuel qui utilise DiscreteObjectKeyFrame pour modifier la visibilité.

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

Remarques

Un élément d’interface utilisateur qui a Visibility égal Collapsed est toujours chargé avec le reste du CODE XAML sur une page et existe dans l’arborescence des objets runtime.

Un élément qui a Visibility égal Collapsed n’a pas d’emplacement dans l’interface utilisateur et ne participe pas aux tests d’entrée ou d’accès. Ils ne sont pas non plus dans une séquence d’onglets et ne peuvent pas être concentrés, même pas par programmation. Si vous souhaitez toujours effectuer des tests d’entrée, de focus ou d’accès, plutôt que de définir Visibilité, utilisez une opacité zéro.

BooleanToVisibilityConverter

Un scénario courant dans les applications qui utilisent des données d’une source de données consiste à identifier une propriété des données ou le modèle de vue pour les données qui contrôle si les données doivent être affichées. Un scénario associé consiste à écrire un modèle qui peut modifier le Visibility d’un composant de contrôle en fonction d’une propriété booléenne du contrôle parent ou d’une autre partie. Pour faciliter la définition de ce comportement dans le cadre d’une liaison, certains des modèles de projet par défaut incluent une classe d’assistance BooleanToVisibilityConverter dans le dossier Common. Pour plus d’informations sur l’utilisation d’un convertisseur de valeurs pour une liaison de données, consultez IValueConverter.

Voir aussi

• Définir des dispositions avec XAML