UIElement.Visibility Propriedade

Definição

Obtém ou define a visibilidade da interface do usuário desse elemento. É uma propriedade de dependência.

public:
 property System::Windows::Visibility Visibility { System::Windows::Visibility get(); void set(System::Windows::Visibility value); };
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public System.Windows.Visibility Visibility { get; set; }
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
member this.Visibility : System.Windows.Visibility with get, set
Public Property Visibility As Visibility

Valor da propriedade

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

Atributos

Exemplos

O exemplo a seguir implementa um manipulador que faz referência a dois botões nomeados diferentes que se destinam a ser um par mutuamente exclusivo na interface do usuário. Antes de executar a lógica real do programa associada ao botão, o próprio botão é definido como Visibility.Hiddene o outro botão no par é definido Visibility.Visiblecomo .

private void PlayMedia(object sender, MouseButtonEventArgs args)
{
    pauseBTN.Visibility = Visibility.Visible;
    playBTN.Visibility = Visibility.Collapsed;

    media.SpeedRatio = 1.0;
    media.Play();
}
Private Sub PlayMedia(ByVal sender As Object, ByVal args As MouseButtonEventArgs)
    pauseBTN.Visibility = System.Windows.Visibility.Visible
    playBTN.Visibility = System.Windows.Visibility.Collapsed

    media.SpeedRatio = 1.0
    media.Play()

End Sub

Comentários

Definir essa propriedade afeta o valor de IsVisible, que, por sua vez, pode gerar o IsVisibleChanged evento. No entanto, IsVisible tem outros fatores que o influenciam, por exemplo, as configurações de visibilidade dos pais que o contêm.

Elementos em Visibility que não Visible participa de eventos de entrada (ou comandos), não influenciam as passagens de medida ou organização do layout, não estão em uma sequência de guias e não serão relatados em testes de clique.

Quando herdado por ou suas Window classes derivadas, Window redefine o valor padrão dessa propriedade como Collapsed. Isso tem o efeito de não executar o passe de medida do layout em um inicialmente criado Windowe RenderSize retorna (0,0). Para obter detalhes, consulte Window. Popup também redefine o valor padrão para ser Collapsed, com um comportamento resultante semelhante para Popup e suas classes derivadas.

Informações da propriedade de dependência

Campo Identificador VisibilityProperty
Propriedades de metadados definidas como true Nenhum

Aplica-se a

Confira também