Class

LinearGradientBrush

Description

Creates an image consisting of a progressive transition between two or more colors along a straight line.

Properties

Name	Type	Read-Only	Shared
EndPoint	Point
GradientStops()	Pair
StartPoint	Point

Property descriptions

LinearGradientBrush.EndPoint

EndPoint As Point

The location within the Graphics object where the gradient will end.

LinearGradientBrush.GradientStops()

GradientStops() As Pair

An array of values indicating the locations where the gradient changes color.

Each element of the array is a Pair where the left value is a position and the right, a Color. The position is the percentage of the area to be drawn with the Color passed.

This example (in the Paint event of a Canvas control) draws an oval with a gradient. The GradientStops property is used to add gradients at 0%, 40%, 70% and 100%. In this example, red will be used from 0% to 40% of the drawing area:

Var linearBrush As New LinearGradientBrush
linearBrush.StartPoint = New Point(0, 0)
linearBrush.EndPoint = New Point(g.Width, g.Height)
linearBrush.GradientStops.Add(New Pair(0.0, Color.Red))
linearBrush.GradientStops.Add(New Pair(0.4, Color.Yellow))
linearBrush.GradientStops.Add(New Pair(0.7, Color.Magenta))
linearBrush.GradientStops.Add(New Pair(1.0, Color.Blue))

g.Brush = linearBrush
g.FillOval(0, 0, g.Width, g.Height)

LinearGradientBrush.StartPoint

StartPoint As Point

The location within the Graphics object where the gradient will start.

Notes

Sample code

This code in the Paint event of a Canvas draws an oval filled with a linear gradient:

Var linearBrush As New LinearGradientBrush
linearBrush.StartPoint = New Point(0, 0)
linearBrush.EndPoint = New Point(g.Width, g.Height)
linearBrush.GradientStops.Add(New Pair(0, Color.Red))
linearBrush.GradientStops.Add(New Pair(0.4, Color.Yellow))
linearBrush.GradientStops.Add(New Pair(0.7, Color.Magenta))
linearBrush.GradientStops.Add(New Pair(1.0, Color.Blue))

g.Brush = linearBrush
g.FillOval(0, 0, g.Width, g.Height)

Compatibility

All project types on all supported operating systems.