UIElement.Visibility 屬性

定義

取得或設定使用者介面 (UI) 這個專案的可見度。 這是相依性屬性。

C#
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public System.Windows.Visibility Visibility { get; set; }

屬性值

列舉值。 預設值是 Visible

屬性

範例

下列範例會實作一個處理常式,參考兩個不同的具名按鈕,這些按鈕是使用者介面中的互斥配對。 在執行與按鈕相關聯的實際程式邏輯之前,按鈕本身會設定為 Visibility.Hidden ,而且配對中的其他按鈕會設定為 Visibility.Visible

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

    media.SpeedRatio = 1.0;
    media.Play();
}

備註

設定這個屬性會影響 的值 IsVisible ,而這個值會接著引發 IsVisibleChanged 事件。 不過, IsVisible 有其他因素會影響它,例如包含它的父系可見度設定。

VisibilityVisible 參與輸入事件的專案 (或命令) ,不會影響版面配置的量值或排列階段、不在索引標籤序列中,也不會在點擊測試中報告。

由 或其衍生類別繼承 Window 時, Window 請將此屬性的預設值重新定義為 Collapsed 。 這會影響在最初建立 Window 的 上執行版面配置量值傳遞,並 RenderSize 傳回 (0,0) 。 如需詳細資訊,請參閱 WindowPopup 也會將預設值重新定義為 Collapsed ,其會產生類似的行為 Popup ,以及其衍生類別。

相依性屬性資訊

識別碼欄位 VisibilityProperty
設定為 的中繼資料屬性 true

適用於

產品 版本
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

另請參閱