UIElement.Visibility Właściwość

Definicja

Pobiera lub ustawia widoczność tego elementu w interfejsie użytkownika. Jest to właściwość zależności.

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

Wartość właściwości

Wartość wyliczenia. Wartość domyślna to Visible.

Atrybuty

Przykłady

W poniższym przykładzie zaimplementowano procedurę obsługi, która odwołuje się do dwóch różnych nazwanych przycisków, które mają być wzajemnie wykluczaną parą w interfejsie użytkownika. Przed uruchomieniem rzeczywistej logiki programu skojarzonej z przyciskiem sam przycisk ma wartość Visibility.Hidden, a drugi przycisk w parze ma wartość Visibility.Visible.

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

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

Uwagi

Ustawienie tej właściwości wpływa na wartość IsVisible, która z kolei może zgłosić IsVisibleChanged zdarzenie. Jednak IsVisible ma inne czynniki wpływające na nie, na przykład ustawienia widoczności elementów nadrzędnych, które go zawierają.

Elementy, w których Visibility nie Visible uczestniczą w zdarzeniach wejściowych (lub poleceniach), nie mają wpływu na przebieg miary lub rozmieszczania układu, nie są w sekwencji tabulacji i nie będą zgłaszane w testach trafień.

Po dziedziczeniu przez Window klasy pochodne lub jej klasy Window pochodne ponownie definiuje wartość domyślną tej właściwości na Collapsed. Ma to wpływ na brak uruchamiania przekazywania miary układu na utworzonym początkowo Windowobiekcie i RenderSize zwraca wartość (0,0). Aby uzyskać szczegółowe informacje, zobacz Window. Popup ponadto ponownie definiuje wartość domyślną na Collapsed, z podobnym zachowaniem wynikowym dla Popup i jej klas pochodnych.

Informacje dotyczące właściwości zależności

Pole identyfikatora VisibilityProperty
Właściwości metadanych ustawione na true Brak

Dotyczy

Produkt Wersje
.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

Zobacz też