LinearGradientBrush
Namespace: System.Drawing.Drawing2D
Assembly: System.Drawing.Managed (4.0.0.0)
Encapsulates a Brush with a linear gradient. This class cannot be inherited.
- C#
- VB.NET
public class LinearGradientBrush : Brush
Public Class LinearGradientBrush
Inherits Brush
Constructors
LinearGradientBrush(point1, point2, color1, color2)
Initializes a new instance of the LinearGradientBrush class with the specified points and colors.
| Name | Type | Description |
|---|---|---|
| point1 | PointF | A PointF structure that represents the starting point of the linear gradient. |
| point2 | PointF | A PointF structure that represents the endpoint of the linear gradient. |
| color1 | Color | A Color structure that represents the starting color of the linear gradient. |
| color2 | Color | A Color structure that represents the ending color of the linear gradient. |
LinearGradientBrush(point1, point2, color1, color2)
Initializes a new instance of the LinearGradientBrush class with the specified points and colors.
| Name | Type | Description |
|---|---|---|
| point1 | Point | A Point structure that represents the starting point of the linear gradient. |
| point2 | Point | A Point structure that represents the endpoint of the linear gradient. |
| color1 | Color | A Color structure that represents the starting color of the linear gradient. |
| color2 | Color | A Color structure that represents the ending color of the linear gradient. |
LinearGradientBrush(rect, color1, color2, linearGradientMode)
Initializes a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation mode.
| Name | Type | Description |
|---|---|---|
| rect | RectangleF | A RectangleF structure that specifies the bounds of the linear gradient. |
| color1 | Color | A Color structure that represents the starting color for the gradient. |
| color2 | Color | A Color structure that represents the ending color for the gradient. |
| linearGradientMode | LinearGradientMode | A LinearGradientMode enumeration element that specifies the orientation of the gradient. The orientation determines the starting and ending points of the gradient. For example, specifies that the starting point is the upper-left corner of the rectangle and the ending point is the lower-right corner of the rectangle. |
LinearGradientBrush(rect, color1, color2, linearGradientMode)
Initializes a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and orientation.
| Name | Type | Description |
|---|---|---|
| rect | Rectangle | A Rectangle structure that specifies the bounds of the linear gradient. |
| color1 | Color | A Color structure that represents the starting color for the gradient. |
| color2 | Color | A Color structure that represents the ending color for the gradient. |
| linearGradientMode | LinearGradientMode | A LinearGradientMode enumeration element that specifies the orientation of the gradient. The orientation determines the starting and ending points of the gradient. For example, specifies that the starting point is the upper-left corner of the rectangle and the ending point is the lower-right corner of the rectangle. |
LinearGradientBrush(rect, color1, color2, angle)
Initializes a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.
| Name | Type | Description |
|---|---|---|
| rect | RectangleF | A RectangleF structure that specifies the bounds of the linear gradient. |
| color1 | Color | A Color structure that represents the starting color for the gradient. |
| color2 | Color | A Color structure that represents the ending color for the gradient. |
| angle | Single | The angle, measured in degrees clockwise from the x-axis, of the gradient's orientation line. |
LinearGradientBrush(rect, color1, color2, angle)
Initializes a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.
| Name | Type | Description |
|---|---|---|
| rect | Rectangle | A Rectangle structure that specifies the bounds of the linear gradient. |
| color1 | Color | A Color structure that represents the starting color for the gradient. |
| color2 | Color | A Color structure that represents the ending color for the gradient. |
| angle | Single | The angle, measured in degrees clockwise from the x-axis, of the gradient's orientation line. |
LinearGradientBrush(rect, color1, color2, angle, isAngleScalable)
Initializes a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.
| Name | Type | Description |
|---|---|---|
| rect | RectangleF | A RectangleF structure that specifies the bounds of the linear gradient. |
| color1 | Color | A Color structure that represents the starting color for the gradient. |
| color2 | Color | A Color structure that represents the ending color for the gradient. |
| angle | Single | The angle, measured in degrees clockwise from the x-axis, of the gradient's orientation line. |
| isAngleScalable | Boolean | Set to to specify that the angle is affected by the transform associated with this LinearGradientBrush; otherwise, . |
LinearGradientBrush(rect, color1, color2, angle, isAngleScalable)
Initializes a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.
| Name | Type | Description |
|---|---|---|
| rect | Rectangle | A Rectangle structure that specifies the bounds of the linear gradient. |
| color1 | Color | A Color structure that represents the starting color for the gradient. |
| color2 | Color | A Color structure that represents the ending color for the gradient. |
| angle | Single | The angle, measured in degrees clockwise from the x-axis, of the gradient's orientation line. |
| isAngleScalable | Boolean | Set to to specify that the angle is affected by the transform associated with this LinearGradientBrush; otherwise, . |
Properties
Blend
Blend: Gets or sets a Blend that specifies positions and factors that define a custom falloff for the gradient.
GammaCorrection
Boolean: Gets or sets a value indicating whether gamma correction is enabled for this LinearGradientBrush.
InterpolationColors
ColorBlend: Gets or sets a ColorBlend that defines a multicolor linear gradient.
LinearColors
Color[]: Gets or sets the starting and ending colors of the gradient.
Rectangle
RectangleF: Gets a rectangular region that defines the starting and ending points of the gradient.
Transform
Matrix: Gets or sets a copy Matrix that defines a local geometric transform for this LinearGradientBrush.
WrapMode
WrapMode: Gets or sets a WrapMode enumeration that indicates the wrap mode for this LinearGradientBrush.
Methods
Clone()
Creates an exact copy of this LinearGradientBrush.
Returns: Object. The LinearGradientBrush this method creates, cast as an object.
MultiplyTransform(matrix)
Multiplies the Matrix object that represents the local geometric transformation of this LinearGradientBrush object by the specified Matrix object by prepending the specified Matrix object.
| Parameter | Type | Description |
|---|---|---|
| matrix | Matrix | The Matrix object by which to multiply the geometric transformation. |
MultiplyTransform(matrix, order)
Multiplies the Matrix object that represents the local geometric transformation of this LinearGradientBrush object by the specified Matrix object in the specified order.
| Parameter | Type | Description |
|---|---|---|
| matrix | Matrix | The Matrix object by which to multiply the geometric transformation. |
| order | MatrixOrder | A MatrixOrder enumeration that specifies the order in which to multiply the two matrices. |
ResetTransform()
Resets the property of this LinearGradientBrush object to identity.
RotateTransform(angle)
Rotates the local geometric transformation of this LinearGradientBrush object by the specified amount. This method prepends the rotation to the transformation.
| Parameter | Type | Description |
|---|---|---|
| angle | Single | The angle of rotation. |
RotateTransform(angle, order)
Rotates the local geometric transformation of this LinearGradientBrush object by the specified amount in the specified order.
| Parameter | Type | Description |
|---|---|---|
| angle | Single | The angle of rotation. |
| order | MatrixOrder | A MatrixOrder enumeration that specifies whether to append or prepend the rotation matrix. |
ScaleTransform(sx, sy)
Scales the local geometric transformation of this LinearGradientBrush object by the specified amounts. This method prepends the scaling matrix to the transformation.
| Parameter | Type | Description |
|---|---|---|
| sx | Single | The amount by which to scale the transformation in the x direction. |
| sy | Single | The amount by which to scale the transformation in the y direction. |
ScaleTransform(sx, sy, order)
Scales the local geometric transformation of this LinearGradientBrush object by the specified amounts in the specified order.
| Parameter | Type | Description |
|---|---|---|
| sx | Single | The amount by which to scale the transformation in the x direction. |
| sy | Single | The amount by which to scale the transformation in the y direction. |
| order | MatrixOrder | A MatrixOrder enumeration that specifies whether to append or prepend the scaling matrix. |
SetBlendTriangularShape(focus)
Creates a linear gradient with a center color and a linear falloff to a single color on both ends.
| Parameter | Type | Description |
|---|---|---|
| focus | Single | A value from 0 through 1 that specifies the center of the gradient (the point where the gradient is composed of only the ending color). |
SetBlendTriangularShape(focus, scale)
Creates a linear gradient with a center color and a linear falloff to a single color on both ends.
| Parameter | Type | Description |
|---|---|---|
| focus | Single | A value from 0 through 1 that specifies the center of the gradient (the point where the gradient is composed of only the ending color). |
| scale | Single | A value from 0 through1 that specifies how fast the colors falloff from the starting color to focus (ending color) |
SetSigmaBellShape(focus)
Creates a gradient falloff based on a bell-shaped curve.
| Parameter | Type | Description |
|---|---|---|
| focus | Single | A value from 0 through 1 that specifies the center of the gradient (the point where the starting color and ending color are blended equally). |
SetSigmaBellShape(focus, scale)
Creates a gradient falloff based on a bell-shaped curve.
| Parameter | Type | Description |
|---|---|---|
| focus | Single | A value from 0 through 1 that specifies the center of the gradient (the point where the gradient is composed of only the ending color). |
| scale | Single | A value from 0 through 1 that specifies how fast the colors falloff from the focus . |
TranslateTransform(dx, dy)
Translates the local geometric transformation of this LinearGradientBrush object by the specified dimensions. This method prepends the translation to the transformation.
| Parameter | Type | Description |
|---|---|---|
| dx | Single | The dimension by which to translate the transformation in the x direction. |
| dy | Single | The dimension by which to translate the transformation in the y direction. |
TranslateTransform(dx, dy, order)
Translates the local geometric transformation of this LinearGradientBrush object by the specified dimensions in the specified order.
| Parameter | Type | Description |
|---|---|---|
| dx | Single | The dimension by which to translate the transformation in the x direction. |
| dy | Single | The dimension by which to translate the transformation in the y direction. |
| order | MatrixOrder | The order (prepend or append) in which to apply the translation. |