LinearGradientBrush.StartPoint Property


Gets or sets the starting two-dimensional coordinates of the linear gradient.

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

public Point StartPoint { get; set; }

Property Value

Type: System.Windows.Point

The starting two-dimensional coordinates for the linear gradient. The default is (0, 0).

A LinearGradientBrush paints a gradient along a line. The line's start and end points are defined by the StartPoint and EndPoint properties of the LinearGradientBrush.

The default linear gradient is diagonal. In the default, the StartPoint of a linear gradient is (0,0), the upper-left corner of the area being filled, and its EndPoint is (1,1), the lower-right corner of the area being filled. The colors in the resulting gradient are interpolated along the diagonal path.

The following image shows a diagonal gradient. The black line was added to highlight the interpolation path of the gradient from the start point to the end point.

Gradient axis for a diagonal linear gradient

A diagonal linear gradient

Note that the MappingMode property of a LinearGradientBrush determines whether its StartPoint is interpreted as a relative or absolute value. A MappingMode of RelativeToBoundingBox specifies that the EndPoint value is relative to the size of the painted area. A MappingMode of Absolute specifies that the StartPoint value is expressed in device independent pixels. By default, the MappingMode is set to RelativeToBoundingBox, making the StartPoint a relative value.

Identifier field


Metadata properties set to true


.NET Framework
Available since 3.0
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top