UIElement.Visibility Propriedade

Definição

Espaço de Nomes:
System.Windows
Assemblagem:
PresentationCore.dll

Obtém ou define a visibilidade da interface de utilizador (UI) deste elemento. Isto é 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 de Propriedade

Visibility

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

Atributos
LocalizabilityAttribute

Exemplos

O exemplo seguinte implementa um handler que faz referência a dois botões nomeados diferentes que se destinam a ser um par mutuamente exclusivo na interface do utilizador. Antes de executar a lógica do programa associada ao botão, o botão em si é definido como Visibility.Hidden, e o outro botão do par é definido como Visibility.Visible.

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

Observações

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

Elementos onde Visibility não Visible está não participam em eventos (ou comandos) de entrada, não influenciam nem as passagens Measure nem Arrange do layout, não estão numa sequência de tabulação e não serão reportados em testes de acerto.

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

Informação de Propriedade de Dependência

Iteme Value
Campo identificador VisibilityProperty
Propriedades dos metadados definidas como true None

Aplica-se a

Ver também