UIElement.Opacity 屬性

定義

取得或設定在使用者介面 (UI) 轉譯時套用至整個 UIElement 的不透明度因數。 這是相依性屬性。

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

屬性值

不透明度因素。 預設不透明度為 1.0。 值必須介於 0.0 到 1.0 之間。

屬性

備註

1.0 預設值是 類別上 UIElement 這個相依性屬性的初始中繼資料所提供的預設值。 其他衍生類別可能會藉由覆寫其類別建構函式內的中繼資料,來變更此預設值。

Opacity的值將不會套用至實際版面配置,除非元素也可見, (IsVisibletrue) 。

Opacity 會從專案樹狀結構上的父元素套用至子項目,但巢狀不透明度設定的可見效果不會顯示在個別子項目的屬性值中。 例如,如果清單有 50% (0.5) 不透明度,且其中一個清單專案本身的不透明度設定為 20% (0.2) , 該清單專案的淨可見不透明度會呈現為 10% (0.1) ,但是查詢清單專案 Opacity 屬性的屬性值仍為 0.2。

即使已宣告或評估的不透明度為 0,元素仍會參與輸入事件和命令,而且可能會有焦點。 例如,這個層面很有用,例如,您可以使用不透明度零的物件 (,例如圖形) ,以透明元素遮罩基礎物件。 不透明度零物件接著可以處理基礎區域的所有輸入事件處理。 不過, Background 物件或圖形的 或 Fill 應該設定為值,即使是 Transparent ,否則不會啟用點擊測試,也不會收到任何事件。

相依性屬性資訊

識別碼欄位 OpacityProperty
設定為 的中繼資料屬性 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

另請參閱