LinearGradientBrush Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Encapsula un Brush con un degradado lineal. Esta clase no se puede heredar.
public ref class LinearGradientBrush sealed : System::Drawing::Brushpublic sealed class LinearGradientBrush : System.Drawing.Brushtype LinearGradientBrush = class
inherit BrushPublic NotInheritable Class LinearGradientBrush
Inherits Brush- Herencia
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. |
Se aplica a
Consulte también
- Cómo: Crear un de degradado lineal
