UIElement.Visibility Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 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 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 Collapsed
a 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 o 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 Comum. Para obter mais informações sobre como usar um conversor de valor para uma associação de dados, consulte IValueConverter.