LinearGradientBrush Clase

Definición

Encapsula un Brush con un degradado lineal.Encapsulates a Brush with a linear gradient. Esta clase no puede heredarse.This class cannot be inherited.

public ref class LinearGradientBrush sealed : System::Drawing::Brush
public sealed class LinearGradientBrush : System.Drawing.Brush
type LinearGradientBrush = class
    inherit Brush
Public NotInheritable Class LinearGradientBrush
Inherits Brush
Herencia
LinearGradientBrush

Ejemplos

En el ejemplo siguiente se crea LinearGradientBrushun horizontal; los componentes de color cambian linealmente a medida que se mueve de una coordenada horizontal de 0 a una coordenada horizontal de 200.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. Por ejemplo, un punto cuya primera coordenada sea la mitad entre 0 y 200 tendrá un componente azul que se encuentra a la mitad de la distancia entre 0 y 255.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. Este ejemplo está diseñado para su uso con Windows Forms.This example is designed for use with Windows Forms. El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que es un parámetro de PaintEventHandler.The following code example is designed for use with Windows Forms, and it requires the PaintEventArgse, which is a parameter of PaintEventHandler.

public void UseHorizontalLinearGradients(PaintEventArgs e)
{
    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);
}
Dim linGrBrush As New LinearGradientBrush( _
   New Point(0, 10), _
   New Point(200, 10), _
   Color.FromArgb(255, 255, 0, 0), _
   Color.FromArgb(255, 0, 0, 255))
Dim pen As 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)

Comentarios

Esta clase encapsula degradados de dos colores y degradados multicolor personalizados.This class encapsulates both two-color gradients and custom multicolor gradients.

Todos los degradados lineales se definen a lo largo de una línea especificada en el ancho de un rectángulo o en dos puntos.All linear gradients are defined along a line specified either by the width of a rectangle or by two points.

De forma predeterminada, un degradado lineal de dos colores es una mezcla lineal horizontal uniforme desde el color inicial hasta el color final a lo largo de la línea especificada.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. Personalice el patrón de Blend mediante Blend la clase, SetSigmaBellShape los métodos o los SetBlendTriangularShape métodos.Customize the blend pattern using the Blend class, the SetSigmaBellShape methods, or the SetBlendTriangularShape methods. Personalice la dirección del degradado especificando la LinearGradientMode enumeración o el ángulo en el constructor.Customize the direction of the gradient by specifying the LinearGradientMode enumeration or the angle in the constructor.

Utilice la InterpolationColors propiedad para crear un degradado multicolor.Use the InterpolationColors property to create a multicolor gradient.

La Transform propiedad especifica una transformación geométrica local aplicada al degradado.The Transform property specifies a local geometric transform applied to the gradient.

Constructores

LinearGradientBrush(Point, Point, Color, Color)

Inicializa una nueva instancia de la clase LinearGradientBrush con los puntos y colores especificados.Initializes a new instance of the LinearGradientBrush class with the specified points and colors.

LinearGradientBrush(PointF, PointF, Color, Color)

Inicializa una nueva instancia de la clase LinearGradientBrush con los puntos y colores especificados.Initializes a new instance of the LinearGradientBrush class with the specified points and colors.

LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode)

Encapsula una nueva instancia de la clase LinearGradientBrush basada en un rectángulo, los colores inicial y final, y la orientación.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and orientation.

LinearGradientBrush(Rectangle, Color, Color, Single)

Crea una nueva instancia de la clase LinearGradientBrush basada en un rectángulo, los colores inicial y final, y un ángulo de orientación.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

LinearGradientBrush(Rectangle, Color, Color, Single, Boolean)

Crea una nueva instancia de la clase LinearGradientBrush basada en un rectángulo, los colores inicial y final, y un ángulo de orientación.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode)

Crea una nueva instancia de LinearGradientBrush basada en un rectángulo, los colores inicial y final, y un modo de orientación.Creates a new instance of the LinearGradientBrush based on a rectangle, starting and ending colors, and an orientation mode.

LinearGradientBrush(RectangleF, Color, Color, Single)

Crea una nueva instancia de la clase LinearGradientBrush basada en un rectángulo, los colores inicial y final, y un ángulo de orientación.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

LinearGradientBrush(RectangleF, Color, Color, Single, Boolean)

Crea una nueva instancia de la clase LinearGradientBrush basada en un rectángulo, los colores inicial y final, y un ángulo de orientación.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

Propiedades

Blend

Obtiene o establece un Blend que especifica las posiciones y factores que definen una disminución personalizada del degradado.Gets or sets a Blend that specifies positions and factors that define a custom falloff for the gradient.

GammaCorrection

Obtiene o establece un valor que indica si se habilitó la corrección gamma para este LinearGradientBrush.Gets or sets a value indicating whether gamma correction is enabled for this LinearGradientBrush.

InterpolationColors

Obtiene o establece un ColorBlend que define un degradado lineal de varios colores.Gets or sets a ColorBlend that defines a multicolor linear gradient.

LinearColors

Obtiene o establece los colores inicial y final del degradado.Gets or sets the starting and ending colors of the gradient.

Rectangle

Obtiene un área rectangular que define los puntos inicial y final del degradado.Gets a rectangular region that defines the starting and ending points of the gradient.

Transform

Obtiene o establece una copia de Matrix que define una transformación geométrica local para este objeto de la clase LinearGradientBrush.Gets or sets a copy Matrix that defines a local geometric transform for this LinearGradientBrush.

WrapMode

Obtiene o establece una enumeración WrapMode que indica el modo de ajuste de este LinearGradientBrush.Gets or sets a WrapMode enumeration that indicates the wrap mode for this LinearGradientBrush.

Métodos

Clone()

Crea una copia exacta de este objeto LinearGradientBrush.Creates an exact copy of this LinearGradientBrush.

CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos utilizados por este objeto Brush.Releases all resources used by this Brush object.

(Heredado de Brush)
Dispose(Boolean)

Libera los recursos no administrados que usa Brush y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the Brush and optionally releases the managed resources.

(Heredado de Brush)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Heredado de MarshalByRefObject)
MultiplyTransform(Matrix)

Multiplica la Matrix que representa la trasformación geométrica local de este LinearGradientBrush por el Matrix anteponiéndole el Matrix especificado.Multiplies the Matrix that represents the local geometric transform of this LinearGradientBrush by the specified Matrix by prepending the specified Matrix.

MultiplyTransform(Matrix, MatrixOrder)

Multiplica la Matrix que representa la transformación geométrica local de este LinearGradientBrush por la Matrix especificada, en el orden indicado.Multiplies the Matrix that represents the local geometric transform of this LinearGradientBrush by the specified Matrix in the specified order.

ResetTransform()

Restablece la propiedad Transform en identidad.Resets the Transform property to identity.

RotateTransform(Single)

Gira la transformación geométrica local la cantidad especificada.Rotates the local geometric transform by the specified amount. Este método antepone la rotación a la transformación.This method prepends the rotation to the transform.

RotateTransform(Single, MatrixOrder)

Gira la transformación geométrica local la cantidad especificada y en el orden especificado.Rotates the local geometric transform by the specified amount in the specified order.

ScaleTransform(Single, Single)

Cambia el tamaño de la transformación geométrica local en las cantidades especificadas.Scales the local geometric transform by the specified amounts. Este método antepone la matriz de escala a la transformación.This method prepends the scaling matrix to the transform.

ScaleTransform(Single, Single, MatrixOrder)

Cambia el tamaño de la transformación geométrica local en las cantidades y en el orden especificados.Scales the local geometric transform by the specified amounts in the specified order.

SetBlendTriangularShape(Single)

Crea un degradado lineal con un color central y una disminución lineal hacia un único color en ambos extremos.Creates a linear gradient with a center color and a linear falloff to a single color on both ends.

SetBlendTriangularShape(Single, Single)

Crea un degradado lineal con un color central y una disminución lineal hacia un único color en ambos extremos.Creates a linear gradient with a center color and a linear falloff to a single color on both ends.

SetNativeBrush(IntPtr)

En una clase derivada, establece una referencia en un objeto Brush de GDI+GDI+.In a derived class, sets a reference to a GDI+GDI+ brush object.

(Heredado de Brush)
SetSigmaBellShape(Single)

Crea una disminución de degradado basada en una curva en forma de campana.Creates a gradient falloff based on a bell-shaped curve.

SetSigmaBellShape(Single, Single)

Crea una disminución de degradado basada en una curva en forma de campana.Creates a gradient falloff based on a bell-shaped curve.

ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)
TranslateTransform(Single, Single)

Convierte la transformación geométrica local en las dimensiones especificadas.Translates the local geometric transform by the specified dimensions. Este método antepone la conversión a la transformación.This method prepends the translation to the transform.

TranslateTransform(Single, Single, MatrixOrder)

Convierte la transformación geométrica local en las dimensiones especificadas en el orden indicado.Translates the local geometric transform by the specified dimensions in the specified order.

Se aplica a

Consulte también: