Langage

UIElement.Visibility Propriété

Définition

Obtient ou définit la visibilité d’un UIElement. Un UIElement élément 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é

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 d’états visuels pour un contrôle, vous souhaiterez parfois modifier l’état Visibility d’un objet Collapseden . Les états visuels s’appuient sur les animations. Le type de valeur de propriété est VisibilityVisibility, énumération. Pour animer des valeurs qui sont des énumérations, vous devez utiliser un objet DiscreteObjectKeyFrame. (Vous utilisez également cette technique pour les valeurs booléennes). Cet exemple XAML montre un état visuel qui permet DiscreteObjectKeyFrame de 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 des valeurs égales Collapsed est toujours chargé avec le reste du code XAML sur une page et existe dans l’arborescence d’objets runtime.

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

BooleanToVisibilityConverter

Un scénario courant dans les applications qui utilisent des données à partir 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ôlent si les données doivent être affichées. Un scénario associé écrit un modèle qui peut modifier le Visibility 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 modèles de projet par défaut incluent une BooleanToVisibilityConverter classe d’assistance dans le dossier Commun. Pour plus d’informations sur l’utilisation d’un convertisseur de valeurs pour une liaison de données, consultez IValueConverter.

S’applique à

Voir aussi