使用英语阅读

通过


UIElement.Opacity 属性

定义

获取或设置在用户界面 (UI) 呈现时应用于整个 UIElement 的不透明度因子。 这是依赖项属性。

[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

另请参阅