PathGradientBrush Clase

Definición

Espacio de nombres:

System.Drawing.Drawing2D

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v8.0.0

Source:

PathGradientBrush.cs

Encapsula un objeto Brush que rellena el interior de un objeto GraphicsPath con un degradado. Esta clase no puede heredarse.

public ref class PathGradientBrush sealed : System::Drawing::Brush

public sealed class PathGradientBrush : System.Drawing.Brush

type PathGradientBrush = class
    inherit Brush

Public NotInheritable Class PathGradientBrush
Inherits Brush

Herencia

Object

MarshalByRefObject

Brush

PathGradientBrush

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear un PathGradientBrush. Este ejemplo está diseñado para su uso con Windows Forms y requiere ePaintEventArgs, que es un parámetro de PaintEventHandler.

public void FillEllipseWithPathGradient(PaintEventArgs e)
{
    // Create a path that consists of a single ellipse.
    GraphicsPath path = new GraphicsPath();
    path.AddEllipse(0, 0, 140, 70);

    // Use the path to construct a brush.
    PathGradientBrush pthGrBrush = new PathGradientBrush(path);

    // Set the color at the center of the path to blue.
    pthGrBrush.CenterColor = Color.FromArgb(255, 0, 0, 255);

    // Set the color along the entire boundary 
    // of the path to aqua.
    Color[] colors = { Color.FromArgb(255, 0, 255, 255) };
    pthGrBrush.SurroundColors = colors;

    e.Graphics.FillEllipse(pthGrBrush, 0, 0, 140, 70);
}

' Create a path that consists of a single ellipse.
Dim path As New GraphicsPath()
path.AddEllipse(0, 0, 140, 70)

' Use the path to construct a brush.
Dim pthGrBrush As New PathGradientBrush(path)

' Set the color at the center of the path to blue.
pthGrBrush.CenterColor = Color.FromArgb(255, 0, 0, 255)

' Set the color along the entire boundary 
' of the path to aqua.
Dim colors As Color() = {Color.FromArgb(255, 0, 255, 255)}
pthGrBrush.SurroundColors = colors

e.Graphics.FillEllipse(pthGrBrush, 0, 0, 140, 70)

Comentarios

El degradado de color es un sombreado suave de colores desde el punto central de la ruta de acceso al borde del límite exterior del trazado. Los factores de mezcla, las posiciones y el estilo afectan a dónde comienza y termina el degradado y la rapidez con la que cambia la sombra.

Los pinceles de degradado de trazado no obedecen la SmoothingMode propiedad del Graphics objeto utilizado para realizar el dibujo. Las áreas rellenas mediante un PathGradientBrush objeto se representan de la misma manera (con alias) independientemente del modo de suavizado.

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

PathGradientBrush(GraphicsPath)	Inicializa una nueva instancia de la clase PathGradientBrush con el trazado especificado.
PathGradientBrush(Point[])	Inicializa una nueva instancia de la clase PathGradientBrush con los puntos especificados.
PathGradientBrush(Point[], WrapMode)	Inicializa una nueva instancia de la clase PathGradientBrush con los puntos y el modo de ajuste especificados.
PathGradientBrush(PointF[])	Inicializa una nueva instancia de la clase PathGradientBrush con los puntos especificados.
PathGradientBrush(PointF[], WrapMode)	Inicializa una nueva instancia de la clase PathGradientBrush con los puntos y el modo de ajuste especificados.

Propiedades

Blend	Obtiene o establece un Blend que especifica las posiciones y factores que definen una disminución personalizada del degradado.
CenterColor	Obtiene o establece el color en el centro del trazado del degradado.
CenterPoint	Obtiene o establece el punto central del trazado del degradado.
FocusScales	Obtiene o establece el punto de foco para la disminución del degradado.
InterpolationColors	Obtiene o establece un ColorBlend que define un degradado lineal de varios colores.
Rectangle	Obtiene un rectángulo delimitador para este PathGradientBrush.
SurroundColors	Obtiene o establece una matriz de colores que corresponden a los puntos del trazado que este PathGradientBrush rellena.
Transform	Obtiene o establece una copia de la clase Matrix que define una transformación geométrica local para este objeto de la clase PathGradientBrush.
WrapMode	Obtiene o establece un modo WrapMode que indica el modo de ajuste para este PathGradientBrush.

Métodos

Clone()	Crea una copia exacta de este objeto PathGradientBrush.
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)	Actualiza la matriz de transformación del pincel con el resultado del producto de la matriz de transformación del pincel multiplicada por otra matriz.
MultiplyTransform(Matrix, MatrixOrder)	Actualiza la matriz de transformación del pincel con el resultado del producto de la matriz de transformación del pincel multiplicada por otra matriz.
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 con un color central y una disminución lineal hacia un color que lo rodea.
SetBlendTriangularShape(Single, Single)	Crea un degradado con un color central y una disminución lineal hacia cada uno de los colores que lo rodean.
SetNativeBrush(IntPtr)	En una clase derivada, establece una referencia a un objeto de pincel GDI+. (Heredado de Brush)
SetSigmaBellShape(Single)	Crea un pincel de degradado que cambia de color comenzando en el centro del trazado y desplazándose hacia el exterior, hasta el límite de la curva. La transición de un color a otro se basa en una curva en forma de campana.
SetSigmaBellShape(Single, Single)	Crea un pincel de degradado que cambia de color comenzando en el centro del trazado y desplazándose hacia el exterior, hasta el límite de la curva. La transición de un color a otro se basa en una curva en forma de campana.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TranslateTransform(Single, Single)	Aplica la conversión especificada a la transformación geométrica local. Este método antepone la conversión a la transformación.
TranslateTransform(Single, Single, MatrixOrder)	Aplica la conversión especificada a la transformación geométrica local en el orden especificado.

Consulte también

• Cómo: Crear un degradado de trazado