LinearGradientBrush Classe

Definição

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v9.0.0-preview.5.24306.5

Origem:

LinearGradientBrush.cs

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 um LinearGradientBrushhorizontal; 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 está entre 0 e 200 terá um componente azul que está na metade entre 0 e 255. Este exemplo foi projetado para uso com o Windows Forms. O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer o PaintEventArgse, 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 os gradientes de duas cores e os gradientes multicolorir 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 classe Blend, os métodos SetSigmaBellShape ou os métodos SetBlendTriangularShape. Personalize a direção do gradiente especificando a enumeração LinearGradientMode ou o ângulo no construtor.

Use a propriedade InterpolationColors para criar um gradiente multicolor.

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

Nota

No .NET 6 e versões posteriores, o pacote System.Drawing.Common, que inclui esse tipo, só tem suporte em sistemas operacionais Windows. O uso desse tipo em aplicativos multiplataforma causa avisos de tempo de compilação e exceções em tempo de execução. 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 cores especificados.
LinearGradientBrush(PointF, PointF, Color, Color)	Inicializa uma nova instância da classe LinearGradientBrush com os pontos e 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 término e orientação.
LinearGradientBrush(Rectangle, Color, Color, Single)	Cria uma nova instância da classe LinearGradientBrush com base em um retângulo, cores de início e término e 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, cores de início e término e um ângulo de orientação.
LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode)	Cria uma nova instância do LinearGradientBrush com base em um retângulo, cores de início e término e um modo de orientação.
LinearGradientBrush(RectangleF, Color, Color, Single)	Cria uma nova instância da classe LinearGradientBrush com base em um retângulo, cores de início e término e 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, cores de início e término e 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 esse LinearGradientBrush.
InterpolationColors	Obtém ou define um ColorBlend que define um gradiente linear multicolor.
LinearColors	Obtém ou define as cores inicial e final do gradiente.
Rectangle	Obtém uma região retangular que define os pontos iniciais e finais do gradiente.
Transform	Obtém ou define uma cópia Matrix que define uma transformação geométrica local para esse LinearGradientBrush.
WrapMode	Obtém ou define uma enumeração WrapMode que indica o modo de encapsulamento para esse 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 este 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 tempo de vida para essa 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 dessa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (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 dessa LinearGradientBrush pelo Matrix especificado, acrescentando o Matrixespecificado.
MultiplyTransform(Matrix, MatrixOrder)	Multiplica o Matrix que representa a transformação geométrica local dessa LinearGradientBrush pelo Matrix especificado na ordem especificada.
ResetTransform()	Redefine a propriedade Transform para identidade.
RotateTransform(Single)	Gira a transformação geométrica local pela quantidade especificada. Esse método prepara a rotação para a transformação.
RotateTransform(Single, MatrixOrder)	Gira a transformação geométrica local pela quantidade especificada na ordem especificada.
ScaleTransform(Single, Single)	Dimensiona a transformação geométrica local pelas quantidades especificadas. Esse método prepara a matriz de dimensionamento para a transformação.
ScaleTransform(Single, Single, MatrixOrder)	Dimensiona 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 prepara a tradução para a 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