UIElement.Opacity 属性

定义

命名空间:

System.Windows

程序集:

PresentationCore.dll

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

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

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

[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
member this.Opacity : double with get, set

Public Property Opacity As Double

属性值

Double

不透明度因子。 默认不透明度为 1.0。 值应介于 0.0 和 1.0 之间。

属性

LocalizabilityAttribute

注解

1.0 默认值是类上 UIElement 此依赖属性的初始元数据提供的默认值。 其他派生类可能通过重写其类构造函数中的元数据来更改此默认值。

Opacity的值不会应用于实际布局，除非元素也可见 (IsVisibletrue) 。

Opacity 从元素树向下的父元素应用于子元素，但嵌套不透明度设置的可见效果不会在单个子元素的属性值中指示。 例如，如果列表具有 50% (0.5) 不透明度，并且其中一个列表项将自己的不透明度设置为 20% (0.2) ， 该列表项的净可见不透明度将呈现为 10% (0.1) ，但查询时列表项 Opacity 属性的属性值仍为 0.2。

即使声明或计算的不透明度为 0，元素仍参与输入事件和命令，并且可能具有可聚焦性。 这一方面可能很有用，例如，可以使用不透明度为零的对象 (如形状) ，以使用透明元素屏蔽基础对象。 然后，不透明度零对象可以处理基础区域的所有输入事件处理。 但是， Background 应将对象或形状的 或 Fill 设置为一个值，即使它是 Transparent，否则不会启用命中测试，并且不会收到任何事件。

依赖项属性信息

标识符字段	OpacityProperty
元数据属性设置为 true	无

另请参阅

• OpacityMask