PathGradientBrush Clase

Definición

Encapsula un objeto Brush que rellena el interior de un objeto GraphicsPath con un degradado.Encapsulates a Brush object that fills the interior of a GraphicsPath object with a gradient. Esta clase no puede heredarse.This class cannot be inherited.

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
PathGradientBrush

Ejemplos

En el ejemplo de código siguiente se muestra cómo PathGradientBrushcrear un.The following code example shows how to create a PathGradientBrush. Este ejemplo está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que es un parámetro de. PaintEventHandlerThis example is designed for use with Windows Forms, and it requires the PaintEventArgs e, which is a parameter of 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 los colores desde el punto central del trazado hasta el borde del límite exterior del trazado.The color gradient is a smooth shading of colors from the center point of the path to the outside boundary edge of the path. Los factores de combinación, las posiciones y el estilo afectan al punto en que se inicia y finaliza el degradado, y la rapidez con la que cambia el sombreado.Blend factors, positions, and style affect where the gradient starts and ends, and how fast it changes shade.

Los pinceles Graphics de degradado de SmoothingMode trazado no obedecen a la propiedad del objeto que se usa para realizar el dibujo.Path gradient brushes do not obey the SmoothingMode property of the Graphics object used to do the drawing. Las áreas rellenas con un PathGradientBrush objeto se representan de la misma manera (con alias), independientemente del modo de suavizado.Areas filled using a PathGradientBrush object are rendered the same way (aliased) regardless of the smoothing mode.

Constructores

PathGradientBrush(GraphicsPath)

Inicializa una nueva instancia de la clase PathGradientBrush con el trazado especificado.Initializes a new instance of the PathGradientBrush class with the specified path.

PathGradientBrush(Point[])

Inicializa una nueva instancia de la clase PathGradientBrush con los puntos especificados.Initializes a new instance of the PathGradientBrush class with the specified points.

PathGradientBrush(Point[], WrapMode)

Inicializa una nueva instancia de la clase PathGradientBrush con los puntos y el modo de ajuste especificados.Initializes a new instance of the PathGradientBrush class with the specified points and wrap mode.

PathGradientBrush(PointF[])

Inicializa una nueva instancia de la clase PathGradientBrush con los puntos especificados.Initializes a new instance of the PathGradientBrush class with the specified points.

PathGradientBrush(PointF[], WrapMode)

Inicializa una nueva instancia de la clase PathGradientBrush con los puntos y el modo de ajuste especificados.Initializes a new instance of the PathGradientBrush class with the specified points and wrap mode.

Propiedades

Blend

Obtiene o establece un Blend que especifica las posiciones y factores que definen una disminución personalizada del degradado.Gets or sets a Blend that specifies positions and factors that define a custom falloff for the gradient.

CenterColor

Obtiene o establece el color en el centro del trazado del degradado.Gets or sets the color at the center of the path gradient.

CenterPoint

Obtiene o establece el punto central del trazado del degradado.Gets or sets the center point of the path gradient.

FocusScales

Obtiene o establece el punto de foco para la disminución del degradado.Gets or sets the focus point for the gradient falloff.

InterpolationColors

Obtiene o establece un ColorBlend que define un degradado lineal de varios colores.Gets or sets a ColorBlend that defines a multicolor linear gradient.

Rectangle

Obtiene un rectángulo delimitador para este PathGradientBrush.Gets a bounding rectangle for this PathGradientBrush.

SurroundColors

Obtiene o establece una matriz de colores que corresponden a los puntos del trazado que este PathGradientBrush rellena.Gets or sets an array of colors that correspond to the points in the path this PathGradientBrush fills.

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.Gets or sets a copy of the Matrix that defines a local geometric transform for this PathGradientBrush.

WrapMode

Obtiene o establece un modo WrapMode que indica el modo de ajuste para este PathGradientBrush.Gets or sets a WrapMode that indicates the wrap mode for this PathGradientBrush.

Métodos

Clone()

Crea una copia exacta de este objeto PathGradientBrush.Creates an exact copy of this 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos utilizados por este objeto Brush.Releases all resources used by this Brush object.

(Heredado de Brush)
Dispose(Boolean)

Libera los recursos no administrados que usa Brush y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the Brush and optionally releases the managed resources.

(Heredado de Brush)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(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.Updates the brush's transformation matrix with the product of brush's transformation matrix multiplied by another matrix.

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.Updates the brush's transformation matrix with the product of the brush's transformation matrix multiplied by another matrix.

ResetTransform()

Restablece la propiedad Transform en identidad.Resets the Transform property to identity.

RotateTransform(Single)

Gira la transformación geométrica local la cantidad especificada.Rotates the local geometric transform by the specified amount. Este método antepone la rotación a la transformación.This method prepends the rotation to the transform.

RotateTransform(Single, MatrixOrder)

Gira la transformación geométrica local la cantidad especificada y en el orden especificado.Rotates the local geometric transform by the specified amount in the specified order.

ScaleTransform(Single, Single)

Cambia el tamaño de la transformación geométrica local en las cantidades especificadas.Scales the local geometric transform by the specified amounts. Este método antepone la matriz de escala a la transformación.This method prepends the scaling matrix to the transform.

ScaleTransform(Single, Single, MatrixOrder)

Cambia el tamaño de la transformación geométrica local en las cantidades y en el orden especificados.Scales the local geometric transform by the specified amounts in the specified order.

SetBlendTriangularShape(Single)

Crea un degradado con un color central y una disminución lineal hacia un color que lo rodea.Creates a gradient with a center color and a linear falloff to one surrounding color.

SetBlendTriangularShape(Single, Single)

Crea un degradado con un color central y una disminución lineal hacia cada uno de los colores que lo rodean.Creates a gradient with a center color and a linear falloff to each surrounding color.

SetNativeBrush(IntPtr)

En una clase derivada, establece una referencia en un objeto Brush de GDI+GDI+.In a derived class, sets a reference to a GDI+GDI+ brush object.

(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.Creates a gradient brush that changes color starting from the center of the path outward to the path's boundary. La transición de un color a otro se basa en una curva en forma de campana.The transition from one color to another is based on a bell-shaped curve.

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.Creates a gradient brush that changes color starting from the center of the path outward to the path's boundary. La transición de un color a otro se basa en una curva en forma de campana.The transition from one color to another is based on a bell-shaped curve.

ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)
TranslateTransform(Single, Single)

Aplica la conversión especificada a la transformación geométrica local.Applies the specified translation to the local geometric transform. Este método antepone la conversión a la transformación.This method prepends the translation to the transform.

TranslateTransform(Single, Single, MatrixOrder)

Aplica la conversión especificada a la transformación geométrica local en el orden especificado.Applies the specified translation to the local geometric transform in the specified order.

Se aplica a

Consulte también: