UIElement.Visibility プロパティ


この要素の ユーザー インターフェイス (UI)user interface (UI) 可視性を取得または設定します。Gets or sets the ユーザー インターフェイス (UI)user interface (UI) visibility of this element. これは依存関係プロパティです。This is a dependency property.

 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; }
member this.Visibility : System.Windows.Visibility with get, set
Public Property Visibility As Visibility



列挙体の値。A value of the enumeration. 既定値は Visible です。The default value is Visible.


次の例では、ユーザーインターフェイスで相互に排他的なペアとして使用する2つの異なる名前付きボタンを参照するハンドラーを実装しています。The following example implements a handler that references two different named buttons that are intended to be a mutually exclusive pair in the user interface. ボタンに関連付けられている実際のプログラムロジックを実行する前に、ボタン自体が Visibility.Hiddenに設定され、ペアのもう1つのボタンが Visibility.Visibleに設定されます。Prior to running the actual program logic associated with the button, the button itself is set to be Visibility.Hidden, and the other button in the pair is set to Visibility.Visible.

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

    media.SpeedRatio = 1.0;
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

End Sub


このプロパティを設定すると、IsVisibleの値に影響します。これにより、IsVisibleChanged イベントが発生する場合があります。Setting this property affects the value of IsVisible, which in turn may raise the IsVisibleChanged event. ただし、IsVisible には、それを含む親の可視性の設定など、それに影響を与える他の要因があります。However, IsVisible has other factors that influence it, for instance the visibility settings of parents that contain it.

VisibilityVisible されていない要素は、入力イベント (またはコマンド) に参加しません。レイアウトのメジャーまたは配置パスに影響を与えることはなく、タブシーケンスには含まれず、ヒットテストでは報告されません。Elements where Visibility is not Visible do not participate in input events (or commands), do not influence either the Measure or Arrange passes of layout, are not in a tab sequence, and will not be reported in hit testing.

Window またはその派生クラスによって継承されると、Window このプロパティの既定値を Collapsedに再定義します。When inherited by Window or its derived classes, Window redefines the default value of this property to be Collapsed. これにより、最初に作成された Windowでレイアウトの測定パスが実行されず、RenderSize (0, 0) が返されます。This has the effect of not running the Measure pass of layout on an initially created Window, and RenderSize returns (0,0). 詳細については、「Window」を参照してください。For details, see Window. また Popup によって、既定値が Collapsedに再定義され、Popup とその派生クラスの動作も同様になります。Popup also redefines the default value to be Collapsed, with similar resulting behavior for Popup and its derived classes.

依存プロパティ情報Dependency Property Information

識別子フィールドIdentifier field VisibilityProperty
メタデータプロパティが true に設定されるMetadata properties set to true NoneNone