UIElement.Visibility Propiedad

Definición

Espacio de nombres:

Windows.UI.Xaml

Obtiene o establece la visibilidad de un UIElement. Un UIElement que no está visible no se representa y no comunica su tamaño deseado al diseño.

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

Valor de propiedad

Visibility

Valor de la enumeración. El valor predeterminado es Visible.

Ejemplos

Visibilidad en un estado visual Como parte de la definición de estados visuales para un control, a veces querrá cambiar el estado Visibilidad de un objeto a Contraído. Los estados visuales se basan en animaciones. El tipo de valor de propiedad de Visibility es Visibility, una enumeración. Para animar valores que son enumeraciones, debe usar un Elemento DiscreteObjectKeyFrame. (También se usa esta técnica para los valores booleanos). En este ejemplo xaml se muestra un estado visual que usa DiscreteObjectKeyFrame para cambiar la visibilidad.

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

Comentarios

Un elemento de interfaz de usuario que tiene Visibility equals Collapsed se sigue cargando junto con el resto del XAML en una página y existe en el árbol de objetos en tiempo de ejecución.

Un elemento que tiene Visibility equals Collapsed no tiene ninguna ubicación en la interfaz de usuario y no participa en las pruebas de entrada o posicionamiento. Tampoco están en una secuencia de tabulaciones y no se pueden centrar, ni siquiera mediante programación. Si aún desea la entrada, el foco o las pruebas de posicionamiento, en lugar de establecer Visibilidad, use una opacidad cero.

BooleanToVisibilityConverter

Un escenario común en las aplicaciones que usan datos de un origen de datos es identificar una propiedad de los datos o el modelo de vista para los datos que controlan si los datos deben mostrarse. Un escenario relacionado está escribiendo una plantilla que puede modificar la visibilidad de un elemento de control en función de una propiedad booleana del control primario o de otra parte. Para facilitar la definición de este comportamiento como parte de un enlace, algunas de las plantillas de proyecto predeterminadas incluyen una clase auxiliar BooleanToVisibilityConverter en la carpeta Common. Para obtener más información sobre cómo usar un convertidor de valores para un enlace de datos, consulte IValueConverter.

Consulte también

• Definir diseños con XAML