LinearGradientBrush Classe

Definição

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Assembly:

System.Drawing.dll

Encapsula um Brush com um gradiente linear. Essa classe não pode ser herdada.

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

Object

MarshalByRefObject

Brush

LinearGradientBrush

Exemplos

O exemplo a seguir cria uma horizontal LinearGradientBrush; os componentes de cor mudam linearmente à medida que você passa de uma coordenada horizontal de 0 para uma coordenada horizontal de 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. Este exemplo foi projetado para uso com 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.

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 gradientes de duas cores e gradientes multicolor personalizados.

Todos os gradientes lineares são definidos ao longo de uma linha especificada pela largura de um retângulo ou por dois pontos.

Por padrão, um gradiente linear de duas cores é uma combinação linear horizontal uniforme da cor inicial à cor final ao longo da linha especificada. Personalize o padrão de combinação usando a Blend classe, os SetSigmaBellShape métodos ou os SetBlendTriangularShape métodos. Personalize a direção do gradiente especificando a LinearGradientMode enumeração ou o ângulo no construtor.

Use a InterpolationColors propriedade para criar um gradiente multicolor.

A Transform propriedade especifica uma transformação geométrica local aplicada ao gradiente.

Observação

No .NET 6 e em versões posteriores, o pacote System.Drawing.Common, que inclui esse tipo, só tem suporte em sistemas Windows operacionais. O uso desse tipo em aplicativos de plataforma cruzada causa avisos de tempo de compilação e exceções de tempo de run-time. Para obter mais informações, consulte System.Drawing.Common com suporte apenas no Windows.

Construtores

LinearGradientBrush(Point, Point, Color, Color)	Inicializa uma nova instância da classe LinearGradientBrush com os pontos e as cores especificados.
LinearGradientBrush(PointF, PointF, Color, Color)	Inicializa uma nova instância da classe LinearGradientBrush com os pontos e as cores especificados.
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.
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.
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.
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.
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.
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.

Propriedades

Blend	Obtém ou define um Blend que especifica posições e fatores que definem uma queda personalizada para o gradiente.
GammaCorrection	Obtém ou define um valor que indica se a correção gama está habilitada para este LinearGradientBrush.
InterpolationColors	Obtém ou define um ColorBlend que define um gradiente linear multicolorido.
LinearColors	Obtém ou define as cores inicial e final do gradiente.
Rectangle	Obtém uma região retangular que define os pontos inicial e final do gradiente.
Transform	Obtém ou define uma cópia Matrix que define uma transformação geométrica local para este LinearGradientBrush.
WrapMode	Obtém ou define uma enumeração WrapMode que indica o modo de encapsulamento para este LinearGradientBrush.

Métodos

Clone()	Cria uma cópia exata deste LinearGradientBrush.
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. (Herdado de MarshalByRefObject)
Dispose()	Libera todos os recursos usados por esse objeto Brush. (Herdado de Brush)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo Brush e opcionalmente libera os recursos gerenciados. (Herdado de Brush)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
MultiplyTransform(Matrix)	Multiplica o Matrix que representa a transformação geométrica local deste LinearGradientBrush pelo Matrix especificado acrescentando o Matrix especificado.
MultiplyTransform(Matrix, MatrixOrder)	Multiplica o Matrix que representa a transformação geométrica local deste LinearGradientBrush pelo Matrix especificado na ordem especificada.
ResetTransform()	Redefine a propriedade Transform para a identidade.
RotateTransform(Single)	Gira a transformação geométrica local pelo valor especificado. Esse método acrescenta a rotação ao começo da transformação.
RotateTransform(Single, MatrixOrder)	Gira a transformação geométrica local pela quantidade especificada na ordem especificada.
ScaleTransform(Single, Single)	Coloca a transformação geométrica local em escala pelos valores especificados. Esse método acrescenta a matriz de colocação em escala ao começo da transformação.
ScaleTransform(Single, Single, MatrixOrder)	Escalas a transformação geométrica local pelos valores especificados na ordem especificada.
SetBlendTriangularShape(Single)	Cria um gradiente linear com uma cor central e uma queda linear para uma única cor em ambas as extremidades.
SetBlendTriangularShape(Single, Single)	Cria um gradiente linear com uma cor central e uma queda linear para uma única cor em ambas as extremidades.
SetNativeBrush(IntPtr)	Em uma classe derivada, define uma referência a um objeto de pincel GDI+. (Herdado de Brush)
SetSigmaBellShape(Single)	Cria uma queda de gradiente com base em uma curva em forma de sino.
SetSigmaBellShape(Single, Single)	Cria uma queda de gradiente com base em uma curva em forma de sino.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TranslateTransform(Single, Single)	Converte a transformação geométrica local pelas dimensões especificadas. Esse método precede a translação à transformação.
TranslateTransform(Single, Single, MatrixOrder)	Converte a transformação geométrica local pelas dimensões especificadas na ordem especificada.

Confira também

• Como criar um gradiente linear