LinearGradientBrush LinearGradientBrush LinearGradientBrush LinearGradientBrush Class

Definição

Encapsula um Brush com um gradiente linear.Encapsulates a Brush with a linear gradient. Essa classe não pode ser herdada.This class cannot be inherited.

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
Herança
LinearGradientBrushLinearGradientBrushLinearGradientBrushLinearGradientBrush

Exemplos

O exemplo a seguir cria um LinearGradientBrushhorizontal; os componentes de cor são alterados linearmente à medida que você move de uma coordenada horizontal de 0 para uma coordenada horizontal de 200.The following example creates a horizontal LinearGradientBrush; the color components change linearly as you move from a horizontal coordinate of 0 to a horizontal coordinate of 200. Por exemplo, um ponto cuja primeira coordenada esteja a meio caminho entre 0 e 200 terá um componente azul a meio caminho entre 0 e 255.For example, a point whose first coordinate is halfway between 0 and 200 will have a blue component that is halfway between 0 and 255. Este exemplo foi projetado para uso com Windows Forms.This example is designed for use with Windows Forms. O exemplo de código a seguir foi projetado para uso com Windows Forms e requer o PaintEventArgs e, que é um parâmetro de PaintEventHandler.The following code example is designed for use with Windows Forms, and it requires the PaintEventArgse, which is a parameter of 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)

Comentários

Essa classe encapsula os gradientes de duas cores e gradientes multicoloridos personalizados.This class encapsulates both two-color gradients and custom multicolor gradients.

Todos os gradientes lineares são definidos ao longo de uma linha especificada pela largura de um retângulo ou por dois pontos.All linear gradients are defined along a line specified either by the width of a rectangle or by two points.

Por padrão, um gradiente linear de duas cores é um Blend linear até mesmo horizontal a partir da cor inicial até a cor final ao longo da linha especificada.By default, a two-color linear gradient is an even horizontal linear blend from the starting color to the ending color along the specified line. Personalize o padrão de mesclagem Blend usando a classe SetSigmaBellShape , os métodos ou SetBlendTriangularShape os métodos.Customize the blend pattern using the Blend class, the SetSigmaBellShape methods, or the SetBlendTriangularShape methods. Personalize a direção do gradiente especificando a LinearGradientMode enumeração ou o ângulo no construtor.Customize the direction of the gradient by specifying the LinearGradientMode enumeration or the angle in the constructor.

Use a InterpolationColors propriedade para criar um gradiente multicolorido.Use the InterpolationColors property to create a multicolor gradient.

A Transform propriedade especifica uma transformação geométrica local aplicada ao gradiente.The Transform property specifies a local geometric transform applied to the gradient.

Construtores

LinearGradientBrush(Point, Point, Color, Color) LinearGradientBrush(Point, Point, Color, Color) LinearGradientBrush(Point, Point, Color, Color) LinearGradientBrush(Point, Point, Color, Color)

Inicializa uma nova instância da classe LinearGradientBrush com os pontos e as cores especificados.Initializes a new instance of the LinearGradientBrush class with the specified points and colors.

LinearGradientBrush(PointF, PointF, Color, Color) LinearGradientBrush(PointF, PointF, Color, Color) LinearGradientBrush(PointF, PointF, Color, Color) LinearGradientBrush(PointF, PointF, Color, Color)

Inicializa uma nova instância da classe LinearGradientBrush com os pontos e as cores especificados.Initializes a new instance of the LinearGradientBrush class with the specified points and colors.

LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode) LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode) LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode) LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode)

Cria uma nova instância da classe LinearGradientBrush com base em um retângulo, cores de início e fim e orientação.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and orientation.

LinearGradientBrush(Rectangle, Color, Color, Single) LinearGradientBrush(Rectangle, Color, Color, Single) LinearGradientBrush(Rectangle, Color, Color, Single) LinearGradientBrush(Rectangle, Color, Color, Single)

Cria uma nova instância da classe LinearGradientBrush com base em um retângulo, nas cores inicial e final e em um ângulo de orientação.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

LinearGradientBrush(Rectangle, Color, Color, Single, Boolean) LinearGradientBrush(Rectangle, Color, Color, Single, Boolean) LinearGradientBrush(Rectangle, Color, Color, Single, Boolean) LinearGradientBrush(Rectangle, Color, Color, Single, Boolean)

Cria uma nova instância da classe LinearGradientBrush com base em um retângulo, nas cores inicial e final e em um ângulo de orientação.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode) LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode) LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode) LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode)

Cria uma nova instância do LinearGradientBrush com base em um retângulo, nas cores inicial e final e em um modo de orientação.Creates a new instance of the LinearGradientBrush based on a rectangle, starting and ending colors, and an orientation mode.

LinearGradientBrush(RectangleF, Color, Color, Single) LinearGradientBrush(RectangleF, Color, Color, Single) LinearGradientBrush(RectangleF, Color, Color, Single) LinearGradientBrush(RectangleF, Color, Color, Single)

Cria uma nova instância da classe LinearGradientBrush com base em um retângulo, nas cores inicial e final e em um ângulo de orientação.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

LinearGradientBrush(RectangleF, Color, Color, Single, Boolean) LinearGradientBrush(RectangleF, Color, Color, Single, Boolean) LinearGradientBrush(RectangleF, Color, Color, Single, Boolean) LinearGradientBrush(RectangleF, Color, Color, Single, Boolean)

Cria uma nova instância da classe LinearGradientBrush com base em um retângulo, nas cores inicial e final e em um ângulo de orientação.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

Propriedades

Blend Blend Blend Blend

Obtém ou define um Blend que especifica posições e fatores que definem uma queda personalizada para o gradiente.Gets or sets a Blend that specifies positions and factors that define a custom falloff for the gradient.

GammaCorrection GammaCorrection GammaCorrection GammaCorrection

Obtém ou define um valor que indica se a correção gama está habilitada para este LinearGradientBrush.Gets or sets a value indicating whether gamma correction is enabled for this LinearGradientBrush.

InterpolationColors InterpolationColors InterpolationColors InterpolationColors

Obtém ou define um ColorBlend que define um gradiente linear multicolorido.Gets or sets a ColorBlend that defines a multicolor linear gradient.

LinearColors LinearColors LinearColors LinearColors

Obtém ou define as cores inicial e final do gradiente.Gets or sets the starting and ending colors of the gradient.

Rectangle Rectangle Rectangle Rectangle

Obtém uma região retangular que define os pontos inicial e final do gradiente.Gets a rectangular region that defines the starting and ending points of the gradient.

Transform Transform Transform Transform

Obtém ou define uma cópia Matrix que define uma transformação geométrica local para este LinearGradientBrush.Gets or sets a copy Matrix that defines a local geometric transform for this LinearGradientBrush.

WrapMode WrapMode WrapMode WrapMode

Obtém ou define uma enumeração WrapMode que indica o modo de encapsulamento para este LinearGradientBrush.Gets or sets a WrapMode enumeration that indicates the wrap mode for this LinearGradientBrush.

Métodos

Clone() Clone() Clone() Clone()

Cria uma cópia exata deste LinearGradientBrush.Creates an exact copy of this LinearGradientBrush.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libera todos os recursos usados por esse objeto Brush.Releases all resources used by this Brush object.

(Inherited from Brush)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera os recursos não gerenciados usados pelo Brush e opcionalmente libera os recursos gerenciados.Releases the unmanaged resources used by the Brush and optionally releases the managed resources.

(Inherited from Brush)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MultiplyTransform(Matrix) MultiplyTransform(Matrix) MultiplyTransform(Matrix) MultiplyTransform(Matrix)

Multiplica o Matrix que representa a transformação geométrica local deste LinearGradientBrush pelo Matrix especificado acrescentando o Matrix especificado.Multiplies the Matrix that represents the local geometric transform of this LinearGradientBrush by the specified Matrix by prepending the specified Matrix.

MultiplyTransform(Matrix, MatrixOrder) MultiplyTransform(Matrix, MatrixOrder) MultiplyTransform(Matrix, MatrixOrder) MultiplyTransform(Matrix, MatrixOrder)

Multiplica o Matrix que representa a transformação geométrica local deste LinearGradientBrush pelo Matrix especificado na ordem especificada.Multiplies the Matrix that represents the local geometric transform of this LinearGradientBrush by the specified Matrix in the specified order.

ResetTransform() ResetTransform() ResetTransform() ResetTransform()

Redefine a propriedade Transform para a identidade.Resets the Transform property to identity.

RotateTransform(Single) RotateTransform(Single) RotateTransform(Single) RotateTransform(Single)

Gira a transformação geométrica local pelo valor especificado.Rotates the local geometric transform by the specified amount. Esse método acrescenta a rotação ao começo da transformação.This method prepends the rotation to the transform.

RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder)

Gira a transformação geométrica local pela quantidade especificada na ordem especificada.Rotates the local geometric transform by the specified amount in the specified order.

ScaleTransform(Single, Single) ScaleTransform(Single, Single) ScaleTransform(Single, Single) ScaleTransform(Single, Single)

Coloca a transformação geométrica local em escala pelos valores especificados.Scales the local geometric transform by the specified amounts. Esse método acrescenta a matriz de colocação em escala ao começo da transformação.This method prepends the scaling matrix to the transform.

ScaleTransform(Single, Single, MatrixOrder) ScaleTransform(Single, Single, MatrixOrder) ScaleTransform(Single, Single, MatrixOrder) ScaleTransform(Single, Single, MatrixOrder)

Escalas a transformação geométrica local pelos valores especificados na ordem especificada.Scales the local geometric transform by the specified amounts in the specified order.

SetBlendTriangularShape(Single) SetBlendTriangularShape(Single) SetBlendTriangularShape(Single) SetBlendTriangularShape(Single)

Cria um gradiente linear com uma cor central e uma queda linear para uma única cor em ambas as extremidades.Creates a linear gradient with a center color and a linear falloff to a single color on both ends.

SetBlendTriangularShape(Single, Single) SetBlendTriangularShape(Single, Single) SetBlendTriangularShape(Single, Single) SetBlendTriangularShape(Single, Single)

Cria um gradiente linear com uma cor central e uma queda linear para uma única cor em ambas as extremidades.Creates a linear gradient with a center color and a linear falloff to a single color on both ends.

SetNativeBrush(IntPtr) SetNativeBrush(IntPtr) SetNativeBrush(IntPtr) SetNativeBrush(IntPtr)

Em uma classe derivada, define uma referência para um objeto de pincel GDI+GDI+.In a derived class, sets a reference to a GDI+GDI+ brush object.

(Inherited from Brush)
SetSigmaBellShape(Single) SetSigmaBellShape(Single) SetSigmaBellShape(Single) SetSigmaBellShape(Single)

Cria uma queda de gradiente com base em uma curva em forma de sino.Creates a gradient falloff based on a bell-shaped curve.

SetSigmaBellShape(Single, Single) SetSigmaBellShape(Single, Single) SetSigmaBellShape(Single, Single) SetSigmaBellShape(Single, Single)

Cria uma queda de gradiente com base em uma curva em forma de sino.Creates a gradient falloff based on a bell-shaped curve.

ToString() ToString() ToString() ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Inherited from Object)
TranslateTransform(Single, Single) TranslateTransform(Single, Single) TranslateTransform(Single, Single) TranslateTransform(Single, Single)

Converte a transformação geométrica local pelas dimensões especificadas.Translates the local geometric transform by the specified dimensions. Esse método precede a translação à transformação.This method prepends the translation to the transform.

TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder)

Converte a transformação geométrica local pelas dimensões especificadas na ordem especificada.Translates the local geometric transform by the specified dimensions in the specified order.

Aplica-se a

Veja também