Partager via


Offset

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

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

<object Offset="Double"  .../>
value = object.Offset
object.Offset = value

Property Value

Type: Double

The relative location of this gradient stop along the gradient vector.

This property is read/write. The default value is 0.

Managed Equivalent

Offset

Remarks

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 the StartPoint property. For a RadialGradientBrush, the 0 offset specifies the GradientOrigin property.

The gradient stop offset factor is then mapped to 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 for this mode and are valid, but the same gradient can be achieved by using values between 0 and 1 if all the gradient stops are adjusted relatively.

Applies To

GradientStop