Lenguaje

UIElement.Visibility Propiedad

Definición

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

Valor de la enumeración. El valor por defecto 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 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 sigue cargado 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 igual 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 consiste en escribir una plantilla que puede modificar el Visibility elemento de un 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, consulte IValueConverter.

Se aplica a

Consulte también