Export (0) Print
Expand All

LinearGradientBrush Class

Encapsulates a Brush with a linear gradient. This class cannot be inherited.

System.Object
  System.MarshalByRefObject
    System.Drawing.Brush
      System.Drawing.Drawing2D.LinearGradientBrush

Namespace:  System.Drawing.Drawing2D
Assembly:  System.Drawing (in System.Drawing.dll)

public sealed class LinearGradientBrush : Brush

The LinearGradientBrush type exposes the following members.

  NameDescription
Public methodLinearGradientBrush(Point, Point, Color, Color)Initializes a new instance of the LinearGradientBrush class with the specified points and colors.
Public methodLinearGradientBrush(PointF, PointF, Color, Color)Initializes a new instance of the LinearGradientBrush class with the specified points and colors.
Public methodLinearGradientBrush(Rectangle, Color, Color, LinearGradientMode)Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and orientation.
Public methodLinearGradientBrush(Rectangle, Color, Color, Single)Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.
Public methodLinearGradientBrush(RectangleF, Color, Color, LinearGradientMode)Creates a new instance of the LinearGradientBrush based on a rectangle, starting and ending colors, and an orientation mode.
Public methodLinearGradientBrush(RectangleF, Color, Color, Single)Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.
Public methodLinearGradientBrush(Rectangle, Color, Color, Single, Boolean)Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.
Public methodLinearGradientBrush(RectangleF, Color, Color, Single, Boolean)Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.
Top

  NameDescription
Public propertyBlendGets or sets a Blend that specifies positions and factors that define a custom falloff for the gradient.
Public propertyGammaCorrectionGets or sets a value indicating whether gamma correction is enabled for this LinearGradientBrush.
Public propertyInterpolationColorsGets or sets a ColorBlend that defines a multicolor linear gradient.
Public propertyLinearColorsGets or sets the starting and ending colors of the gradient.
Public propertyRectangleGets a rectangular region that defines the starting and ending points of the gradient.
Public propertyTransformGets or sets a copy Matrix that defines a local geometric transform for this LinearGradientBrush.
Public propertyWrapModeGets or sets a WrapMode enumeration that indicates the wrap mode for this LinearGradientBrush.
Top

  NameDescription
Public methodCloneCreates an exact copy of this LinearGradientBrush. (Overrides Brush.Clone().)
Public methodCreateObjRefCreates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.)
Public methodDispose()Releases all resources used by this Brush object. (Inherited from Brush.)
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetLifetimeServiceRetrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodInitializeLifetimeServiceObtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Public methodMultiplyTransform(Matrix)Multiplies the Matrix that represents the local geometric transform of this LinearGradientBrush by the specified Matrix by prepending the specified Matrix.
Public methodMultiplyTransform(Matrix, MatrixOrder)Multiplies the Matrix that represents the local geometric transform of this LinearGradientBrush by the specified Matrix in the specified order.
Public methodResetTransformResets the Transform property to identity.
Public methodRotateTransform(Single)Rotates the local geometric transform by the specified amount. This method prepends the rotation to the transform.
Public methodRotateTransform(Single, MatrixOrder)Rotates the local geometric transform by the specified amount in the specified order.
Public methodScaleTransform(Single, Single)Scales the local geometric transform by the specified amounts. This method prepends the scaling matrix to the transform.
Public methodScaleTransform(Single, Single, MatrixOrder)Scales the local geometric transform by the specified amounts in the specified order.
Public methodSetBlendTriangularShape(Single)Creates a linear gradient with a center color and a linear falloff to a single color on both ends.
Public methodSetBlendTriangularShape(Single, Single)Creates a linear gradient with a center color and a linear falloff to a single color on both ends.
Protected methodSetNativeBrushIn a derived class, sets a reference to a GDI+ brush object. (Inherited from Brush.)
Public methodSetSigmaBellShape(Single)Creates a gradient falloff based on a bell-shaped curve.
Public methodSetSigmaBellShape(Single, Single)Creates a gradient falloff based on a bell-shaped curve.
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Public methodTranslateTransform(Single, Single)Translates the local geometric transform by the specified dimensions. This method prepends the translation to the transform.
Public methodTranslateTransform(Single, Single, MatrixOrder)Translates the local geometric transform by the specified dimensions in the specified order.
Top

This class encapsulates both two-color gradients and custom multicolor gradients.

All linear gradients are defined along a line specified either by the width of a rectangle or by two points.

By default, a two-color linear gradient is an even horizontal linear blend from the starting color to the ending color along the specified line. Customize the blend pattern using the Blend class, the SetSigmaBellShape methods, or the SetBlendTriangularShape methods. Customize the direction of the gradient by specifying the LinearGradientMode enumeration or the angle in the constructor.

Use the InterpolationColors property to create a multicolor gradient.

The Transform property specifies a local geometric transform applied to the gradient.

The following example creates a horizontal LinearGradientBrush; the color components change linearly as you move from a horizontal coordinate of 0 to a horizontal coordinate of 200. For example, a point whose first coordinate is halfway between 0 and 200 will have a blue component that is halfway between 0 and 255. This example is designed for use with Windows Forms. The following code example is designed for use with Windows Forms, and it requires the PaintEventArgs e, which is a parameter of PaintEventHandler.

LinearGradientBrush linGrBrush = new LinearGradientBrush(
   new Point(0, 10),
   new Point(200, 10),
   Color.FromArgb(255, 255, 0, 0),   // Opaque red
   Color.FromArgb(255, 0, 0, 255));  // Opaque blue

Pen pen = new Pen(linGrBrush);

e.Graphics.DrawLine(pen, 0, 10, 200, 10);
e.Graphics.FillEllipse(linGrBrush, 0, 30, 200, 100);
e.Graphics.FillRectangle(linGrBrush, 0, 155, 500, 30);

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft