UIElement.Visibility 屬性

定義

命名空間:

Microsoft.UI.Xaml

取得或設定 UIElement的可見度。 UIElement未顯示且不會將其所需的大小傳達給版面配置。

public:
 property Visibility Visibility { Visibility get(); void set(Visibility value); };

Visibility Visibility();

void Visibility(Visibility value);

public Visibility Visibility { get; set; }

var visibility = uIElement.visibility;
uIElement.visibility = visibility;

Public Property Visibility As Visibility

<uiElement Visibility="Visible"/>
-or-
<uiElement Visibility="Collapsed"/>

屬性值

Visibility

列舉值。 預設值是 Visible。

範例

視覺狀態中的可見度 在定義控制項的視覺狀態過程中，您有時會想要將物件的狀態變更 Visibility 為 Collapsed 。 視覺狀態依賴動畫。 的 Visibility 屬性值類型為 Visibility，這是列舉。 若要建立列舉值的動畫效果，您必須使用 DiscreteObjectKeyFrame。 (您也可以將這項技術用於布林值) 。 這個 XAML 範例顯示用來 DiscreteObjectKeyFrame 變更可見度的視覺狀態。

<VisualState x:Name="Focused">
  <Storyboard>
    <ObjectAnimationUsingKeyFrames Storyboard.TargetName="FocusVisualElement" Storyboard.TargetProperty="Visibility" Duration="0">
      <DiscreteObjectKeyFrame KeyTime="0" Value="Visible"/>
    </ObjectAnimationUsingKeyFrames>
  </Storyboard>
</VisualState>

備註

具有 Visibility 等號 Collapsed 的 UI 元素仍會隨著頁面上的其餘 XAML 一起載入，並存在於執行時間物件樹狀結構中。

具有 Visibility 等號 Collapsed 的專案在 UI 中沒有位置，而且不會參與輸入或點擊測試。 它們也不在索引標籤序列中，而且無法以程式設計方式聚焦。 如果您仍然想要輸入、焦點或點擊測試，而不是設定 Visibility 使用零不透明度。

BooleanToVisibilityConverter

使用資料來源資料之應用程式中的常見案例是識別資料的屬性，或控制資料是否應該顯示之資料的檢視模型。 相關的案例是撰寫範本，可根據父控制項或另一個元件的布林值屬性來改變 Visibility 控制群組件的 。 為了更輕鬆地將此行為定義為 Binding的一部分，部分預設專案範本會在 Common 資料夾中包含 BooleanToVisibilityConverter 協助程式類別。 如需如何使用值轉換器進行資料系結的詳細資訊，請參閱 IValueConverter。

另請參閱

• 使用 XAML 定義版面配置