PathGradientBrush 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 um Brush objeto que preenche o interior de um GraphicsPath objeto com um gradiente. Esta classe não pode ser herdada.
public ref class PathGradientBrush sealed : System::Drawing::Brushpublic sealed class PathGradientBrush : System.Drawing.Brushtype PathGradientBrush = class
inherit BrushPublic NotInheritable Class PathGradientBrush
Inherits Brush- Herança
Exemplos
O seguinte exemplo de código mostra como criar um PathGradientBrush. Este exemplo foi concebido 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)
Observações
O gradiente de cor é uma sombra suave das cores desde o ponto central do caminho até à borda exterior do percurso. Fatores de mistura, posições e estilo afetam onde o gradiente começa e termina, e a rapidez com que muda de tom.
Os pincéis de gradiente de caminho não obedecem à SmoothingMode propriedade do Graphics objeto usado para fazer o desenho. As áreas preenchidas com um PathGradientBrush objeto são renderizadas da mesma forma (aliasadas), 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ó é 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 |
|---|---|
| PathGradientBrush(GraphicsPath) |
Inicializa uma nova instância da PathGradientBrush classe com o caminho especificado. |
| PathGradientBrush(Point[], WrapMode) |
Inicializa uma nova instância da PathGradientBrush classe com os pontos especificados e o modo wrap. |
| PathGradientBrush(Point[]) |
Inicializa uma nova instância da PathGradientBrush classe com os pontos especificados. |
| PathGradientBrush(PointF[], WrapMode) |
Inicializa uma nova instância da PathGradientBrush classe com os pontos especificados e o modo wrap. |
| PathGradientBrush(PointF[]) |
Inicializa uma nova instância da PathGradientBrush classe com os pontos especificados. |
Propriedades
| Name | Description |
|---|---|
| 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 do caminho. |
| CenterPoint |
Obtém ou define o ponto central do gradiente do caminho. |
| FocusScales |
Obtém ou define o ponto de foco para a queda do gradiente. |
| InterpolationColors |
Obtém ou define um ColorBlend que define um gradiente linear multicolorido. |
| Rectangle |
Obtém-se um retângulo delimitador para este PathGradientBrush. |
| SurroundColors |
Obtém ou define um array 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 transformada geométrica local para este PathGradientBrush. |
| WrapMode |
Obtém ou define um WrapMode que indica o modo de envolvimento para este PathGradientBrush. |
Métodos
| Name | Description |
|---|---|
| Clone() |
Cria uma cópia exata deste PathGradientBrush. |
| 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) |
Atualiza a matriz de transformação do pincel com o produto da matriz de transformação do pincel multiplicado por outra matriz. |
| MultiplyTransform(Matrix) |
Atualiza a matriz de transformação do pincel com o produto da matriz de transformação do pincel multiplicado por outra matriz. |
| 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 com uma cor central e uma queda linear para cada cor envolvente. |
| SetBlendTriangularShape(Single) |
Cria um gradiente com uma cor central e uma queda linear para uma cor envolvente. |
| SetNativeBrush(IntPtr) |
Numa classe derivada, define uma referência para um objeto pincel GDI+. (Herdado de Brush) |
| SetSigmaBellShape(Single, Single) |
Cria um pincel de gradiente que muda de cor a partir do centro do caminho para fora até ao limite do caminho. A transição de uma cor para outra baseia-se numa curva em forma de sino. |
| SetSigmaBellShape(Single) |
Cria um pincel de gradiente que muda de cor a partir do centro do caminho para fora até ao limite do caminho. A transição de uma cor para outra baseia-se numa curva em forma de sino. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| TranslateTransform(Single, Single, MatrixOrder) |
Aplica a translação especificada à transformação geométrica local na ordem especificada. |
| TranslateTransform(Single, Single) |
Aplica a translação especificada à transformação geométrica local. Este método antepõe a translação à transformada. |