GradientBrush.MappingMode Property

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

Gets or sets a BrushMappingMode enumeration value that specifies whether the positioning coordinates of the gradient brush are absolute or relative to the output area.

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

Syntax

'Declaration
Public Property MappingMode As BrushMappingMode
public BrushMappingMode MappingMode { get; set; }
<gradientBrush MappingMode="Absolute"/>
-or-
<gradientBrush MappingMode="RelativeToBoundingBox"/>

Property Value

Type: System.Windows.Media.BrushMappingMode
A BrushMappingMode value that specifies how to interpret the gradient brush's positioning coordinates. The default is BrushMappingMode.RelativeToBoundingBox.

Remarks

Dependency property identifier field: MappingModeProperty

A value of Absolute indicates the gradient brush's coordinates are expressed in pixels. A value of BrushMappingMode.RelativeToBoundingBox indicates that the gradient brush's coordinates are expressed as a logical factor between 0 and 1.

The MappingMode of a LinearGradientBrush or RadialGradientBrush does not influence how the Offset values are interpreted. Regardless of mapping mode, the offset is always interpreted as a factor between 0 and 1 along the vector that defines the gradient.

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.

See Also

Reference

Other Resources