PathGradientBrush Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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::Brushpublic sealed class PathGradientBrush : System.Drawing.Brushtype PathGradientBrush = class
inherit BrushPublic NotInheritable Class PathGradientBrush
Inherits Brush- Herança
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. |
