LinearGradientBrush Clase

Definición

Espacio de nombres:

System.Drawing.Drawing2D

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v9.0.0-rc.1.24451.1

Source:

LinearGradientBrush.cs

Encapsula un Brush con un degradado lineal. Esta clase no se puede heredar.

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

Object

MarshalByRefObject

Brush

LinearGradientBrush

Ejemplos

En el ejemplo siguiente se crea un LinearGradientBrushhorizontal ; los componentes de color cambian linealmente a medida que se mueve de una coordenada horizontal de 0 a una coordenada horizontal de 200. Por ejemplo, un punto cuya primera coordenada está a mitad de camino entre 0 y 200 tendrá un componente azul que esté medio entre 0 y 255. Este ejemplo está diseñado para su uso con Windows Forms. El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere el PaintEventArgse, que es un parámetro de 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 los degradados de dos colores y los degradados multicolor personalizados.

Todos los degradados lineales se definen a lo largo de una línea especificada por el ancho de un rectángulo o por dos puntos.

De forma predeterminada, un degradado lineal de dos colores es una combinación lineal horizontal uniforme desde el color inicial hasta el color final a lo largo de la línea especificada. Personalice el patrón de mezcla mediante la clase Blend, los métodos SetSigmaBellShape o los métodos SetBlendTriangularShape. Personalice la dirección del degradado especificando la enumeración LinearGradientMode o el ángulo del constructor.

Utilice la propiedad InterpolationColors para crear un degradado multicolor.

La propiedad Transform especifica una transformación geométrica local aplicada al degradado.

Nota

En .NET 6 y versiones posteriores, el paquete System.Drawing.Common, que incluye este tipo, solo se admite en sistemas operativos Windows. El uso de este tipo en aplicaciones multiplataforma provoca advertencias en tiempo de compilación y excepciones en tiempo de ejecución. Para obtener más información, vea System.Drawing.Common solo se admite en Windows.

Constructores

LinearGradientBrush(Point, Point, Color, Color)	Inicializa una nueva instancia de la clase LinearGradientBrush con los puntos y colores especificados.
LinearGradientBrush(PointF, PointF, Color, Color)	Inicializa una nueva instancia de la clase LinearGradientBrush con los puntos y colores especificados.
LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode)	Crea una nueva instancia de la clase LinearGradientBrush basada en un rectángulo, colores iniciales y finales y orientación.
LinearGradientBrush(Rectangle, Color, Color, Single)	Crea una nueva instancia de la clase LinearGradientBrush basada en un rectángulo, colores iniciales y finales, y un ángulo de orientación.
LinearGradientBrush(Rectangle, Color, Color, Single, Boolean)	Crea una nueva instancia de la clase LinearGradientBrush basada en un rectángulo, colores iniciales y finales, y un ángulo de orientación.
LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode)	Crea una nueva instancia de la LinearGradientBrush basada en un rectángulo, colores iniciales y finales, y un modo de orientación.
LinearGradientBrush(RectangleF, Color, Color, Single)	Crea una nueva instancia de la clase LinearGradientBrush basada en un rectángulo, colores iniciales y finales, y un ángulo de orientación.
LinearGradientBrush(RectangleF, Color, Color, Single, Boolean)	Crea una nueva instancia de la clase LinearGradientBrush basada en un rectángulo, colores iniciales y finales, y un ángulo de orientación.

Propiedades

Blend	Obtiene o establece un Blend que especifica posiciones y factores que definen una caída personalizada para el degradado.
GammaCorrection	Obtiene o establece un valor que indica si la corrección gamma está habilitada para este LinearGradientBrush.
InterpolationColors	Obtiene o establece un ColorBlend que define un degradado lineal multicolor.
LinearColors	Obtiene o establece los colores iniciales y finales del degradado.
Rectangle	Obtiene una región rectangular que define los puntos iniciales y finales del degradado.
Transform	Obtiene o establece una copia Matrix que define una transformación geométrica local para este LinearGradientBrush.
WrapMode	Obtiene o establece una enumeración de WrapMode que indica el modo de ajuste para este LinearGradientBrush.

Métodos

Clone()	Crea una copia exacta de este LinearGradientBrush.
CreateObjRef(Type)	Crea un objeto que contiene toda la información pertinente necesaria para generar un proxy usado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos utilizados por este objeto Brush. (Heredado de Brush)
Dispose(Boolean)	Libera los recursos no administrados usados por el Brush y, opcionalmente, libera los recursos administrados. (Heredado de Brush)
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Obsoletos. Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	Obsoletos. Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
MultiplyTransform(Matrix)	Multiplica el Matrix que representa la transformación geométrica local de este LinearGradientBrush por el Matrix especificado anteponiendo el Matrixespecificado.
MultiplyTransform(Matrix, MatrixOrder)	Multiplica el Matrix que representa la transformación geométrica local de este LinearGradientBrush por el Matrix especificado en el orden especificado.
ResetTransform()	Restablece la propiedad Transform a la identidad.
RotateTransform(Single)	Gira la transformación geométrica local por la cantidad especificada. Este método antepone la rotación a la transformación.
RotateTransform(Single, MatrixOrder)	Gira la transformación geométrica local por la cantidad especificada en el orden especificado.
ScaleTransform(Single, Single)	Escala la transformación geométrica local por las cantidades especificadas. Este método antepone la matriz de escalado a la transformación.
ScaleTransform(Single, Single, MatrixOrder)	Escala la transformación geométrica local por las cantidades especificadas en el orden especificado.
SetBlendTriangularShape(Single)	Crea un degradado lineal con un color central y una caída lineal a un solo color en ambos extremos.
SetBlendTriangularShape(Single, Single)	Crea un degradado lineal con un color central y una caída lineal a un solo color en ambos extremos.
SetNativeBrush(IntPtr)	En una clase derivada, establece una referencia a un objeto de pincel GDI+. (Heredado de Brush)
SetSigmaBellShape(Single)	Crea una caída degradada basada en una curva en forma de campana.
SetSigmaBellShape(Single, Single)	Crea una caída degradada basada en una curva en forma de campana.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TranslateTransform(Single, Single)	Traduce la transformación geométrica local por las dimensiones especificadas. Este método antepone la traducción a la transformación.
TranslateTransform(Single, Single, MatrixOrder)	Traduce la transformación geométrica local por las dimensiones especificadas en el orden especificado.

Consulte también

• Cómo: Crear un de degradado lineal