Gets or sets the brush that is used to alter the opacity of select regions of this object.
<object ...>
<object.OpacityMask>
singleBrush
</object.OpacityMask>
</object>
value = object.OpacityMask
object.OpacityMask = value
Type: Brush
A Brush that describes the opacity of this object.
This property is read/write. The default value is null.
OpacityMask
This property uses the alpha channel value for the supplied Brush. The other channels of the brush content (Red, Green, or Blue) are ignored.
The most typical Brush for this purpose is an ImageBrush, which can be used for a variety of photo masking techniques such as vignettes. However, any defined Brush (such as LinearGradientBrush) can be used. All brushes require a Brush-derived object element to fill property element syntax in XAML, as shown in the XAML syntax earlier in this topic.
The following example creates a RadialGradientBrush with three gradient stops in the implicit GradientStopCollection. The three gradient stops specify a brush with a varying transparency, which is then applied as the OpacityMask for an Image.
<Canvas
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
<Image Source="sampleImages/forest.jpg" Height="100">
<Image.OpacityMask>
<RadialGradientBrush Center="0.5,0.5">
<!-- This gradient stop is partially transparent. -->
<GradientStop Color="#00000000" Offset="1" />
<!-- This gradient stop is partially transparent. -->
<GradientStop Color="#20000000" Offset="0.8" />
<!-- This gradient stop is fully opaque. -->
<GradientStop Color="#FF000000" Offset="0" />
</RadialGradientBrush>
</Image.OpacityMask>
</Image>
</Canvas>
The following illustration shows the rendered result of the preceding code.
RadialGradientBrush applied to OpacityMask of an image
.png)
Border (Silverlight 2)
Canvas
Ellipse
Glyphs
Image
InkPresenter
Line
MediaElement
PasswordBox (Silverlight 2)
Path
Polygon
Polyline
Popup (Silverlight 2)
Rectangle
StackPanel (Silverlight 2)
TextBlock
TextBox (Silverlight 2)