Visibility获取或设置某一元素的用户界面 (UI) 的可见性

XAML

 

<object Visibility="Visible"  .../>
-or-
<object Visibility="Collapsed"  .../>

JScript

 

value = object.Visibility
object.Visibility = value

属性值

---

类型：Visibility 枚举

一个指出对象的当前可见性的枚举值。

此属性是可读/写的。 默认值为 Visible。

托管等效项

---

Visibility

备注

---

如果某一元素的 Visibility 属性值不是 Visible，则该元素并不参与输入事件，不在 Tab 键序列中，并且不会在命中测试中包括。

说明：

当有对象未设置为 Visible 时，IsHitTestVisible 的值将被忽略。 IsHitTestVisible 是可设置属性，使您可以禁用元素的命中测试，由于这些元素的 Visibility 和 Background 属性值，可能会对它们进行命中测试。

Visibility 使用枚举而非简单布尔，因为它基于 Windows Presentation Foundation (WPF) Visibility 属性，该属性使用 Visible、Hidden 和 Collapsed 的三态模型。 在 WPF 模型中，Hidden 表示一个可见性状态，在该状态中，对象不应呈现但仍在 WPF 布局中占用空间。 Silverlight 1.0 不支持 Hidden 可见性状态，但它仍使用保留的 Visibility 枚举值（Visible 和 Collapsed）。 如果您正在从 WPF 导入 XAML UI 定义，则可能需要更改 Visibility 声明为 Hidden 的情况，以便在 Silverlight 1.0 中使用这些 XAML 定义。

示例

---

下面的 XAML 示例演示如何将 TextBlock 的 Visibility 属性设置为 Visible。

XAML

 

<Canvas
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  Background="Wheat">
  <TextBlock
    Text="Click me!"
    Visibility="Visible"
    Canvas.Left="20"
    FontSize="24"
    MouseLeftButtonUp="onMouseLeftButtonUp" />
</Canvas>

下面的 JavaScript 示例演示如何将 TextBlock 的 Visibility 属性设置为 Collapsed。

JScript

 

function onMouseLeftButtonUp(sender, mouseEventArgs)
{
    // TextBlock collapsed.
    sender.visibility = "Collapsed";
    // The IsHitTestVisible property is ignored during hit-testing;
    // it is still set to true for an element whose Visibility is Collapsed, has null or Transparent Brush, or Opacity=0.
    alert(sender.isHitTestVisible);
}