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.
See Also