Partilhar via


UIElement.Visibility Propriedade

Definição

Obtém ou define a visibilidade de um UIElement. Um UIElement que não está visível não é renderizado e não comunica o tamanho desejado para o layout.

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 da propriedade

Um valor da enumeração. O valor padrão é Visible.

Exemplos

Visibilidade em um estado visual Como parte da definição de estados visuais para um controle, às vezes você desejará alterar o estado visibilidade de um objeto para Collapsed. Os estados visuais dependem de animações. O tipo de valor de propriedade de Visibility é Visibility, uma enumeração. Para animar valores que são enumerações, você deve usar um DiscreteObjectKeyFrame. (Você também usa essa técnica para valores boolianos). Este exemplo XAML mostra um estado visual que usa DiscreteObjectKeyFrame para alterar a visibilidade.

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

Comentários

Um elemento de interface do usuário que tem Visibility igual a Collapsed ainda é carregado junto com o restante do XAML em uma página e existe na árvore de objetos de runtime.

Um elemento que tem Visibility igual a Collapsed não tem local na interface do usuário e não participa de testes de entrada ou de clique. Eles também não estão em uma sequência de guias e não podem ser focados, nem mesmo programaticamente. Se você ainda quiser fazer testes de entrada, foco ou clique, em vez de definir Visibilidade, use uma Opacidade zero.

Booleantovisibilityconverter

Um cenário comum em aplicativos que usam dados de uma fonte de dados é identificar uma propriedade dos dados ou o modelo de exibição dos dados que controla se os dados devem ser exibidos. Um cenário relacionado é escrever um modelo que pode alterar a Visibilidade de uma parte de controle com base em uma propriedade booliana do controle pai ou de outra parte. Para facilitar a definição desse comportamento como parte de uma Associação, alguns dos modelos de projeto padrão incluem uma classe auxiliar BooleanToVisibilityConverter na pasta Common. Para obter mais informações sobre como usar um conversor de valor para uma associação de dados, consulte IValueConverter.

Aplica-se a

Confira também