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 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
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() |
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 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. |
Se aplica a
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente las Cuestiones de GitHub como mecanismo de retroalimentación para el contenido y lo sustituiremos por un nuevo sistema de retroalimentación. Para más información, consulta:Enviar y ver comentarios de