MultiScaleSubImage.Opacity Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets or sets the degree of the MultiScaleSubImage opacity.

Namespace:  System.Windows.Controls
Assembly:  System.Windows (in System.Windows.dll)

Syntax

'Declaration
Public Property Opacity As Double
public double Opacity { get; set; }

Property Value

Type: System.Double
A value between 0 and 1.0 that declares the opacity, with 1.0 meaning full opacity and 0 meaning transparent. The default value is 1.0.

Remarks

Dependency property identifier field: OpacityProperty

An Opacity value of 0 does not exclude MultiScaleSubImage from hit testing. For example, a completely transparent MultiScaleSubImage would still shield elements underneath it from a mouse event like MouseLeftButtonDown.

When Opacity is set on elements that are nested, the effective opacity is the product of all applicable opacity factors. For instance, if an element that has Opacity=0.5 is contained in a Canvas that is also Opacity=0.5, the effective Opacity value is 0.25.

Opacity values greater than 1.0 are treated as 1.0 when the value is used, although obtaining the property value will still give you the original greater-than-one value. Opacity values less than 0 are treated as 0 when the value is used. For instance, setting an Opacity to 2 to cancel out the effects of a nested element with 0.5 Opacity does not work; the 2 value is treated as 1.0 even before the nested-element factoring is calculated.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.