Développer Réduire

UIElement.Visibility Property

Obtient ou définit la visibilité d'un UIElement. UIElement qui n'est pas visible n'est pas restitué et ne communique pas ses dimensions souhaitées à la disposition.

Syntaxe

Public Property Visibility As Visibility
   Get
   Set

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

Valeur de propriété

Type: Visibility

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

Remarques

Un élément d'interface utilisateur qui a Visibility égal à Collapsed est toujours chargé avec le reste du code XAML dans une page et existe dans l'arborescence d'objets d'exécution.

Un élément avec Visibility équivalant à Collapsed n'a aucun emplacement dans l'interface utilisateur et ne participe pas à l'entrée ou au test de positionnement. Ils ne se trouvent également pas dans une séquence d'onglets et ne peuvent pas avoir le focus, même pas par programme. Si vous souhaitez toujours la saisie, le focus ou les tests d'atteinte, au lieu de définir Visibility, utilisez une valeur de zéro pour Opacity.

BooleanToVisibilityConverter

Un scénario courant dans les applications qui utilisent des données d'une source de données est d'identifier une propriété des données ou du modèle de vue des données qui contrôlent si les données doivent s'afficher. Un scénario associé écrit un modèle qui peut modifier la Visibility d'une partie de contrôle basée sur une propriété booléenne du contrôle parent ou d'une autre partie. Pour simplifier la définition de ce comportement dans le cadre d'une Binding, certains des modèles de projet par défaut incluent une classe d'assistance BooleanToVisibilityConverter dans le dossier Common. Pour plus d'informations sur le mode d'utilisation d'un convertisseur de valeurs pour une liaison de données, consultez IValueConverter.

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 de Visibility d'un objet et le passer à l'état Collapsed. Les états visuels reposent sur les animations. Le type de valeur de propriété de Visibility est Visibility, soit une énumération. Pour animer des valeurs qui sont des énumérations, vous devez utiliser DiscreteObjectKeyFrame. (Vous utilisez également cette technique pour les valeurs booléennes). Cet exemple de code XAML présente 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>

Configuration requise

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

Espace de noms

Windows.UI.Xaml
Windows::UI::Xaml [C++]

Métadonnées

Windows.winmd

Voir aussi

UIElement
Démarrage rapide : définition des dispositions

 

 

Afficher:
© 2014 Microsoft