Compartilhar via


PathGradientBrush Classe

Definição

Encapsula um objeto Brush que preenche o interior de um objeto GraphicsPath com um gradiente. Essa classe não pode ser herdada.

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

Exemplos

O exemplo de código a seguir mostra como criar um PathGradientBrush. Este exemplo foi projetado para uso com Windows Forms e requer o PaintEventArgs e, que é um parâmetro de 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)

Comentários

O gradiente de cor é um sombreamento suave de cores do ponto central do caminho até a borda externa do limite do caminho. Os fatores, as posições e o estilo de combinação afetam onde o gradiente começa e termina e a rapidez com que ele muda a sombra.

Pincéis de gradiente de caminho não obedecem à SmoothingMode propriedade do Graphics objeto usado para fazer o desenho. As áreas preenchidas usando um PathGradientBrush objeto são renderizadas da mesma maneira (com alias) independentemente do modo de suavização.

Observação

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

PathGradientBrush(GraphicsPath)

Inicializa uma nova instância da classe PathGradientBrush com o caminho especificado.

PathGradientBrush(Point[])

Inicializa uma nova instância da classe PathGradientBrush com pontos especificados.

PathGradientBrush(Point[], WrapMode)

Inicializa uma nova instância da classe PathGradientBrush com o modo de encapsulamento e os pontos especificados.

PathGradientBrush(PointF[])

Inicializa uma nova instância da classe PathGradientBrush com pontos especificados.

PathGradientBrush(PointF[], WrapMode)

Inicializa uma nova instância da classe PathGradientBrush com o modo de encapsulamento e os pontos especificados.

Propriedades

Blend

Obtém ou define um Blend que especifica posições e fatores que definem uma queda personalizada para o gradiente.

CenterColor

Obtém ou define a cor no centro do gradiente de caminho.

CenterPoint

Obtém ou define o ponto central do gradiente de caminho.

FocusScales

Obtém ou define o ponto de foco para a queda de gradiente.

InterpolationColors

Obtém ou define um ColorBlend que define um gradiente linear multicolorido.

Rectangle

Obtém um retângulo delimitador para este PathGradientBrush.

SurroundColors

Obtém ou define uma matriz de cores que correspondem aos pontos no caminho que este PathGradientBrush preenche.

Transform

Obtém ou define uma cópia do Matrix que define uma transformação geométrica local para este PathGradientBrush.

WrapMode

Obtém ou define um WrapMode que indica o modo encapsulamento para este PathGradientBrush.

Métodos

Clone()

Cria uma cópia exata deste PathGradientBrush.

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)

Atualiza a matriz de transformação do pincel com o produto da matriz de transformação do pincel multiplicado por outra matriz.

MultiplyTransform(Matrix, MatrixOrder)

Atualiza a matriz de transformação do pincel com o produto da matriz de transformação do pincel multiplicado por outra matriz.

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 com uma cor central e uma queda linear para uma cor ao redor.

SetBlendTriangularShape(Single, Single)

Cria um gradiente com uma cor central e uma queda linear para cada cor ao redor.

SetNativeBrush(IntPtr)

Em uma classe derivada, define uma referência a um objeto de pincel GDI+.

(Herdado de Brush)
SetSigmaBellShape(Single)

Cria um pincel de gradiente que muda de cor do centro do caminho para fora até o limite do caminho. A transição de uma cor para outra se baseia em uma curva em forma de sino.

SetSigmaBellShape(Single, Single)

Cria um pincel de gradiente que muda de cor do centro do caminho para fora até o limite do caminho. A transição de uma cor para outra se baseia em uma curva em forma de sino.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
TranslateTransform(Single, Single)

Aplica a translação especificada à transformação geométrica local. Esse método precede a translação à transformação.

TranslateTransform(Single, Single, MatrixOrder)

Aplica a translação especificada a uma transformação geométrica local na ordem especificada.

Aplica-se a

Confira também