UIElement.Visibility 属性

定义

获取或设置用户界面 (UI) 此元素的可见性。 这是依赖项属性。

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

属性值

枚举的一个值。 默认值是 Visible

属性

示例

以下示例实现一个处理程序,该处理程序引用两个不同的命名按钮,这些按钮旨在成为用户界面中的互斥对。 在运行与按钮关联的实际程序逻辑之前,按钮本身设置为 Visibility.Hidden,并且该对中的另一个按钮设置为 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

注解

设置此属性会影响 的值 IsVisible,而该值反过来可能会引发 IsVisibleChanged 事件。 但是, IsVisible 具有影响它的其他因素,例如包含它的父级的可见性设置。

没有 VisibilityVisible 的元素不参与输入事件 (或命令) ,不影响布局的 Measure 或 Arrange 传递,不在选项卡序列中,并且不会在命中测试中报告。

当由 Window 或其派生类继承时, Window 将此属性 Collapsed的默认值重新定义为 。 这样做的效果是不会在最初创建的 Window上运行布局的 Measure pass,并 RenderSize 返回 (0,0) 。 有关详细信息,请参阅 WindowPopup 还会将默认值 Collapsed重新定义为 ,其结果行为 Popup 与 及其派生类的行为相似。

依赖项属性信息

标识符字段 VisibilityProperty
元数据属性设置为 true

适用于

另请参阅