LinearGradientBrush Clase

Definición

Espacio de nombres:

System.Drawing.Drawing2D

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v8.0.0

Source:

LinearGradientBrush.cs

Encapsula un Brush con un degradado lineal. Esta clase no puede heredarse.

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 objeto horizontal LinearGradientBrush; 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 la mitad entre 0 y 200 tendrá un componente azul que está a mitad camino 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 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 incluso horizontal desde el color inicial hasta el color final a lo largo de la línea especificada. Personalice el patrón de mezcla mediante la Blend clase , los SetSigmaBellShape métodos o los SetBlendTriangularShape métodos . Personalice la dirección del degradado especificando la LinearGradientMode enumeración o el ángulo en el constructor.

Utilice la InterpolationColors propiedad para crear un degradado multicolor.

La Transform propiedad 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, consulte System.Drawing.Common only supported on Windows(System.Drawing.Common only supported on 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)	Encapsula una nueva instancia de la clase LinearGradientBrush basada en un rectángulo, los colores inicial y final, y la orientación.
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.
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.
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.
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.
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.

Propiedades

Blend	Obtiene o establece un Blend que especifica las posiciones y factores que definen una disminución personalizada del degradado.
GammaCorrection	Obtiene o establece un valor que indica si se habilitó la corrección gamma para este LinearGradientBrush.
InterpolationColors	Obtiene o establece un ColorBlend que define un degradado lineal de varios colores.
LinearColors	Obtiene o establece los colores inicial y final del degradado.
Rectangle	Obtiene un área rectangular que define los puntos inicial y final del degradado.
Transform	Obtiene o establece una copia de Matrix que define una transformación geométrica local para este objeto de la clase LinearGradientBrush.
WrapMode	Obtiene o establece una enumeración WrapMode que indica el modo de ajuste de este LinearGradientBrush.

Métodos

Clone()	Crea una copia exacta de este objeto 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. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos utilizados por este objeto Brush. (Heredado de Brush)
Dispose(Boolean)	Libera los recursos no administrados que usa Brush y, de forma opcional, libera los recursos administrados. (Heredado de Brush)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	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()	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 Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (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.
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.
ResetTransform()	Restablece la propiedad Transform en identidad.
RotateTransform(Single)	Gira la transformación geométrica local la cantidad especificada. Este método antepone la rotación a la transformación.
RotateTransform(Single, MatrixOrder)	Gira la transformación geométrica local la cantidad especificada y en el orden especificado.
ScaleTransform(Single, Single)	Cambia el tamaño de la transformación geométrica local en las cantidades especificadas. Este método antepone la matriz de escala a la transformación.
ScaleTransform(Single, Single, MatrixOrder)	Cambia el tamaño de la transformación geométrica local en las cantidades y en el orden especificados.
SetBlendTriangularShape(Single)	Crea un degradado lineal con un color central y una disminución lineal hacia un único color en ambos extremos.
SetBlendTriangularShape(Single, Single)	Crea un degradado lineal con un color central y una disminución lineal hacia un único 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 disminución de degradado basada en una curva en forma de campana.
SetSigmaBellShape(Single, Single)	Crea una disminución de degradado basada en una curva en forma de campana.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TranslateTransform(Single, Single)	Convierte la transformación geométrica local en las dimensiones especificadas. Este método antepone la conversión a la transformación.
TranslateTransform(Single, Single, MatrixOrder)	Convierte la transformación geométrica local en las dimensiones especificadas en el orden indicado.

Consulte también

• Cómo: Create un degradado lineal