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 ao 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 Visibility estado de um objeto para Collapsed. Os estados visuais dependem de animações. O tipo de valor da Visibility propriedade é 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 iguais 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 iguais Collapsed não tem nenhum 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 entrada, foco ou teste de 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 para os dados que controlam se os dados devem ser exibidos. Um cenário relacionado está escrevendo um modelo que pode alterar a Visibility 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 BooleanToVisibilityConverter classe auxiliar 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

  • Definir layouts com XAML