UIElement.Visibility プロパティ


この要素のユーザーインターフェイス (UI) の可視性を取得または設定します。Gets or sets the 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; }
[<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



列挙体の値。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. ボタンに関連付けられている実際のプログラムロジックを実行する前に、ボタン自体がに設定され、ペアのもう1つのボタンがに設定されてい Visibility.Hidden 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
メタデータプロパティがに設定される trueMetadata properties set to true なしNone