LinearGradientBrush Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Encapsula a Brush com um gradiente linear. Esta classe não pode ser herdada.
public ref class LinearGradientBrush sealed : System::Drawing::Brushpublic sealed class LinearGradientBrush : System.Drawing.Brushtype LinearGradientBrush = class
inherit BrushPublic NotInheritable Class LinearGradientBrush
Inherits Brush- Herança
Exemplos
O exemplo seguinte cria um horizontal LinearGradientBrush; os componentes de cor mudam linearmente à medida que se passa de uma coordenada horizontal 0 para uma coordenada horizontal de 200. Por exemplo, um ponto cuja primeira coordenada está a meio caminho entre 0 e 200 terá um componente azul que está a meio caminho entre 0 e 255. Este exemplo foi concebido para uso com o Windows Forms. O seguinte exemplo de código foi concebido para uso com 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)
Observações
Esta classe engloba tanto gradientes de duas cores como gradientes multicolor personalizados.
Todos os gradientes lineares são definidos ao longo de uma linha especificada quer pela largura de um retângulo, quer por dois pontos.
Por defeito, um gradiente linear de duas cores é uma mistura linear horizontal uniforme desde a cor inicial até à cor final ao longo da linha especificada. Personaliza o padrão de mistura 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 multicolorido.
A Transform propriedade especifica uma transformação geométrica local aplicada ao gradiente.
Note
No .NET 6 e versões posteriores, o pacote System.Drawing.Common, que inclui esse tipo, só é suportado em sistemas operacionais Windows. O uso deste tipo em aplicações multiplataforma causa avisos em tempo de compilação e exceções em tempo de execução. Para obter mais informações, consulte System.Drawing.Common suportado apenas no Windows.
Construtores
| Name | Description |
|---|---|
| LinearGradientBrush(Point, Point, Color, Color) |
Inicializa uma nova instância da LinearGradientBrush classe com os pontos e cores especificados. |
| LinearGradientBrush(PointF, PointF, Color, Color) |
Inicializa uma nova instância da LinearGradientBrush classe com os pontos e cores especificados. |
| LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode) |
Cria uma nova instância da LinearGradientBrush classe com base num retângulo, cores iniciais e finais e orientação. |
| LinearGradientBrush(Rectangle, Color, Color, Single, Boolean) |
Cria uma nova instância da LinearGradientBrush classe com base num retângulo, cores iniciais e finais, e num ângulo de orientação. |
| LinearGradientBrush(Rectangle, Color, Color, Single) |
Cria uma nova instância da LinearGradientBrush classe com base num retângulo, cores iniciais e finais, e num ângulo de orientação. |
| LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode) |
Cria uma nova instância do LinearGradientBrush baseado num retângulo, cores iniciais e terminais, e num modo de orientação. |
| LinearGradientBrush(RectangleF, Color, Color, Single, Boolean) |
Cria uma nova instância da LinearGradientBrush classe com base num retângulo, cores iniciais e finais, e num ângulo de orientação. |
| LinearGradientBrush(RectangleF, Color, Color, Single) |
Cria uma nova instância da LinearGradientBrush classe com base num retângulo, cores iniciais e finais, e num ângulo de orientação. |
Propriedades
| Name | Description |
|---|---|
| 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á ativada 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-se uma região retangular que define os pontos de início e de fim do gradiente. |
| Transform |
Obtém ou define uma cópia Matrix que define uma transformada geométrica local para este LinearGradientBrush. |
| WrapMode |
Obtém ou define uma WrapMode enumeração que indica o modo de envolvimento para este LinearGradientBrush. |
Métodos
| Name | Description |
|---|---|
| Clone() |
Cria uma cópia exata deste LinearGradientBrush. |
| CreateObjRef(Type) |
Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto. (Herdado de MarshalByRefObject) |
| Dispose() |
Liberta todos os recursos utilizados por este Brush objeto. (Herdado de Brush) |
| Dispose(Boolean) |
Liberta os recursos não geridos usados pelo Brush e opcionalmente liberta os recursos geridos. (Herdado de Brush) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetLifetimeService() |
Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso. (Herdado de MarshalByRefObject) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| InitializeLifetimeService() |
Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| MultiplyTransform(Matrix, MatrixOrder) |
Multiplica o Matrix que representa a transformada geométrica local deste LinearGradientBrush por o especificado Matrix na ordem especificada. |
| MultiplyTransform(Matrix) |
Multiplica o Matrix que representa a transformada geométrica local de este LinearGradientBrush por o especificado Matrix , prependendo o especificado Matrix. |
| ResetTransform() |
Repõe a Transform propriedade para identidade. |
| RotateTransform(Single, MatrixOrder) |
Roda a transformada geométrica local pela quantidade especificada na ordem especificada. |
| RotateTransform(Single) |
Roda a transformada geométrica local pela quantidade especificada. Este método antepõe a rotação à transformada. |
| ScaleTransform(Single, Single, MatrixOrder) |
Escala a transformação geométrica local pelos valores especificados na ordem especificada. |
| ScaleTransform(Single, Single) |
Escala a transformada geométrica local pelas quantidades especificadas. Este método antepõe a matriz de escala à transformada. |
| SetBlendTriangularShape(Single, Single) |
Cria um gradiente linear com uma cor central e uma queda linear para uma única cor em ambas as extremidades. |
| SetBlendTriangularShape(Single) |
Cria um gradiente linear com uma cor central e uma queda linear para uma única cor em ambas as extremidades. |
| SetNativeBrush(IntPtr) |
Numa classe derivada, define uma referência para um objeto pincel GDI+. (Herdado de Brush) |
| SetSigmaBellShape(Single, Single) |
Cria uma queda de gradiente baseada numa curva em forma de sino. |
| SetSigmaBellShape(Single) |
Cria uma queda de gradiente baseada numa curva em forma de sino. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| TranslateTransform(Single, Single, MatrixOrder) |
Traduz a transformada geométrica local pelas dimensões especificadas na ordem especificada. |
| TranslateTransform(Single, Single) |
Traduz a transformação geométrica local pelas dimensões especificadas. Este método antepõe a translação à transformada. |