GradientStop.Offset Property

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

Gets the location of the gradient stop within the gradient vector.

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

Syntax

'Declaration
Public Property Offset As Double
public double Offset { get; set; }
<GradientStop Offset="double"/>

Property Value

Type: System.Double
The relative location of this gradient stop along the gradient vector. The default is 0.

Remarks

Dependency property identifier field: OffsetProperty

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. A value of 0 specifies that the stop is positioned at the beginning of the gradient vector, while a value of 1.0 specifies that the stop is positioned at the end of the gradient vector. For a LinearGradientBrush the 0 offset specifies its StartPoint. For a RadialGradientBrush the 0 offset specifies its GradientOrigin. This gradient stop offset factor is then mapped onto how each type of brush specifies its vector. A LinearGradientBrush vector follows a line that runs from its StartPoint to its EndPoint. A RadialGradientBrush vector radiates from its GradientOrigin towards the ellipse formed by Center, RadiusX, and RadiusY.

Values slightly above 1 or slightly below 0 will influence the gradient and are valid, but the same resulting gradient could probably be achieved entirely using values between 0 and 1 if all the gradient stops are adjusted relatively.

For examples and illustrations, see Brushes.

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.