Ler em inglês

Compartilhar via


UIElement.Visibility Propriedade

Definição

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

C#
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public System.Windows.Visibility Visibility { get; set; }

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 .

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

    media.SpeedRatio = 1.0;
    media.Play();
}

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

Produto Versões
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Confira também