UIElement.Visibility Propiedad

Definición

Espacio de nombres:

Microsoft.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 Visibility estado de un objeto a Collapsed. 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 igual 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 igual Collapsed no tiene Visibility 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 tabulación y no se pueden centrar, ni siquiera mediante programación. Si sigues deseando la entrada, el foco o las pruebas de posicionamiento, en lugar de establecer Visibility, usa 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 consiste en escribir una plantilla que pueda modificar el Visibility de una parte 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 BooleanToVisibilityConverter clase auxiliar en la carpeta Common. Para obtener más información sobre cómo usar un convertidor de valores para un enlace de datos, consulta IValueConverter.

Consulte también

• Definir diseños con XAML