GraphicsPath Classe

Definição

Espaço de Nomes:
System.Drawing.Drawing2D
Assemblagem:
System.Drawing.dll

Representa uma série de linhas e curvas ligadas. Esta classe não pode ser herdada.

public ref class GraphicsPath sealed : MarshalByRefObject, ICloneable, IDisposable
public sealed class GraphicsPath : MarshalByRefObject, ICloneable, IDisposable
type GraphicsPath = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
Public NotInheritable Class GraphicsPath
Inherits MarshalByRefObject
Implements ICloneable, IDisposable
Herança
Object
MarshalByRefObject
GraphicsPath
Implementações
ICloneable IDisposable

Observações

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.

As aplicações usam caminhos para desenhar contornos de formas, preencher o interior das formas e criar regiões de recorte. O motor gráfico mantém as coordenadas de formas geométricas num percurso no espaço de coordenadas do mundo.

Um caminho pode ser composto por qualquer número de figuras (subcaminhos). Cada figura é composta por uma sequência de linhas e curvas conectadas ou por uma primitiva de forma geométrica. O ponto de partida de uma figura é o primeiro ponto na sequência de retas e curvas ligadas. O ponto final é o último ponto da sequência. Os pontos de início e de fim de uma primitiva de forma geométrica são definidos pela especificação primitiva.

Uma figura que consiste numa sequência de retas e curvas conexas (cujos pontos de início e fim podem coincidir) é uma figura aberta, a menos que seja fechada explicitamente. Uma figura pode ser fechada explicitamente, usando o CloseFigure método , que fecha a figura atual ligando uma linha do ponto final ao ponto de partida. Uma figura que consiste numa forma geométrica primitiva é uma figura fechada.

Para efeitos de preenchimento e recorte (por exemplo, se um caminho for renderizado usando FillPath), todas as figuras abertas são fechadas adicionando uma linha do primeiro ponto da figura ao seu último ponto.

Uma nova figura é implicitamente iniciada quando um caminho é criado ou quando uma figura é fechada. Uma nova figura é criada explicitamente quando o StartFigure método é chamado.

Quando uma primitiva de forma geométrica é adicionada a um caminho, adiciona-se uma figura contendo a forma geométrica e, implicitamente, inicia uma nova figura. Consequentemente, há sempre uma figura atual num percurso. Quando linhas e curvas são adicionadas a um caminho, uma linha implícita é adicionada conforme necessário para ligar o ponto final da figura atual ao ponto de partida das novas linhas e curvas para formar uma sequência de linhas e curvas ligadas.

Uma figura tem uma direção que descreve como os segmentos de linha e curva são traçados entre o ponto de partida e o ponto final. A direção é definida pela ordem em que as linhas e curvas são adicionadas a uma figura, ou é definida pela forma primitiva geométrica. A direção é usada para determinar os interiores do caminho para clipping e fill.

Construtores

Name Description
GraphicsPath()

Inicializa uma nova instância da GraphicsPath classe com um FillMode valor de Alternate.
GraphicsPath(FillMode)

Inicializa uma nova instância da GraphicsPath classe com a enumeração especificada FillMode .
GraphicsPath(Point[], Byte[], FillMode)

Inicializa uma nova instância da GraphicsPath classe com os arrays e Point especificados PathPointType e com o elemento de enumeração especificadoFillMode.
GraphicsPath(Point[], Byte[])

Inicializa uma nova instância da GraphicsPath classe com os arrays e Point especificadosPathPointType.
GraphicsPath(PointF[], Byte[], FillMode)

Inicializa uma nova instância do GraphicsPath array com os arrays e PointF especificados PathPointType e com o elemento de enumeração especificadoFillMode.
GraphicsPath(PointF[], Byte[])

Inicializa uma nova instância do GraphicsPath array com os arrays e PointF especificadosPathPointType.

Propriedades

Name Description
FillMode

Obtém ou estabelece uma FillMode enumeração que determina como os interiores das formas aqui GraphicsPath estão preenchidos.
PathData

Obtém um PathData que encapsula arrays de pontos e tipos para este GraphicsPath.
PathPoints

Fica com os pontos no caminho.
PathTypes

Obtém os tipos dos pontos correspondentes no PathPoints array.
PointCount

Obtém o número de elementos no PathPoints ou no PathTypes array.

Métodos

Name Description
AddArc(Int32, Int32, Int32, Int32, Single, Single)

Acrescenta um arco elíptico à figura atual.
AddArc(Rectangle, Single, Single)

Acrescenta um arco elíptico à figura atual.
AddArc(RectangleF, Single, Single)

Acrescenta um arco elíptico à figura atual.
AddArc(Single, Single, Single, Single, Single, Single)

Acrescenta um arco elíptico à figura atual.
AddBezier(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Adiciona uma curva cúbica de Bézier à figura atual.
AddBezier(Point, Point, Point, Point)

Adiciona uma curva cúbica de Bézier à figura atual.
AddBezier(PointF, PointF, PointF, PointF)

Adiciona uma curva cúbica de Bézier à figura atual.
AddBezier(Single, Single, Single, Single, Single, Single, Single, Single)

Adiciona uma curva cúbica de Bézier à figura atual.
AddBeziers(Point[])

Adiciona uma sequência de curvas cúbicas de Bézier conexas à figura atual.
AddBeziers(PointF[])

Adiciona uma sequência de curvas cúbicas de Bézier conexas à figura atual.
AddClosedCurve(Point[], Single)

Adiciona uma curva fechada a este caminho. Uma curva spline cardinal é usada porque a curva passa por cada um dos pontos do arranjo.
AddClosedCurve(Point[])

Adiciona uma curva fechada a este caminho. Uma curva spline cardinal é usada porque a curva passa por cada um dos pontos do arranjo.
AddClosedCurve(PointF[], Single)

Adiciona uma curva fechada a este caminho. Uma curva spline cardinal é usada porque a curva passa por cada um dos pontos do arranjo.
AddClosedCurve(PointF[])

Adiciona uma curva fechada a este caminho. Uma curva spline cardinal é usada porque a curva passa por cada um dos pontos do arranjo.
AddCurve(Point[], Int32, Int32, Single)

Adiciona uma curva spline ao valor atual.
AddCurve(Point[], Single)

Adiciona uma curva spline ao valor atual.
AddCurve(Point[])

Adiciona uma curva spline ao valor atual. Uma curva spline cardinal é usada porque a curva passa por cada um dos pontos do arranjo.
AddCurve(PointF[], Int32, Int32, Single)

Adiciona uma curva spline ao valor atual.
AddCurve(PointF[], Single)

Adiciona uma curva spline ao valor atual.
AddCurve(PointF[])

Adiciona uma curva spline ao valor atual. Uma curva spline cardinal é usada porque a curva passa por cada um dos pontos do arranjo.
AddEllipse(Int32, Int32, Int32, Int32)

Adiciona uma elipse ao caminho atual.
AddEllipse(Rectangle)

Adiciona uma elipse ao caminho atual.
AddEllipse(RectangleF)

Adiciona uma elipse ao caminho atual.
AddEllipse(Single, Single, Single, Single)

Adiciona uma elipse ao caminho atual.
AddLine(Int32, Int32, Int32, Int32)

Acrescenta um segmento de linha à figura atual.
AddLine(Point, Point)

Acrescenta um segmento de linha a este GraphicsPath.
AddLine(PointF, PointF)

Acrescenta um segmento de linha a este GraphicsPath.
AddLine(Single, Single, Single, Single)

Acrescenta um segmento de linha a este GraphicsPath.
AddLines(Point[])

Acrescenta uma série de segmentos de linha ligados ao final deste GraphicsPath.
AddLines(PointF[])

Acrescenta uma série de segmentos de linha ligados ao final deste GraphicsPath.
AddPath(GraphicsPath, Boolean)

Acrescenta o especificado GraphicsPath a este caminho.
AddPie(Int32, Int32, Int32, Int32, Single, Single)

Adiciona o contorno de uma forma de tarte a este caminho.
AddPie(Rectangle, Single, Single)

Adiciona o contorno de uma forma de tarte a este caminho.
AddPie(Single, Single, Single, Single, Single, Single)

Adiciona o contorno de uma forma de tarte a este caminho.
AddPolygon(Point[])

Adiciona um polígono a este caminho.
AddPolygon(PointF[])

Adiciona um polígono a este caminho.
AddRectangle(Rectangle)

Adiciona um retângulo a este caminho.
AddRectangle(RectangleF)

Adiciona um retângulo a este caminho.
AddRectangles(Rectangle[])

Adiciona uma série de retângulos a este caminho.
AddRectangles(RectangleF[])

Adiciona uma série de retângulos a este caminho.
AddString(String, FontFamily, Int32, Single, Point, StringFormat)

Adiciona uma cadeia de texto a este caminho.
AddString(String, FontFamily, Int32, Single, PointF, StringFormat)

Adiciona uma cadeia de texto a este caminho.
AddString(String, FontFamily, Int32, Single, Rectangle, StringFormat)

Adiciona uma cadeia de texto a este caminho.
AddString(String, FontFamily, Int32, Single, RectangleF, StringFormat)

Adiciona uma cadeia de texto a este caminho.
ClearMarkers()

Limpa todos os marcos deste caminho.
Clone()

Cria uma cópia exata deste caminho.
CloseAllFigures()

Fecha todas as figuras abertas neste caminho e começa uma nova figura. Fecha cada figura aberta ligando uma linha do seu ponto final ao ponto de partida.
CloseFigure()

Fecha a figura atual e começa uma nova figura. Se a figura atual contiver uma sequência de linhas e curvas ligadas, o método fecha o laço ligando uma linha do ponto final ao ponto de partida.
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 GraphicsPath.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Finalize()

Permite que um objeto tente libertar recursos e realizar outras operações de limpeza antes de ser recuperado pela recolha de lixo.
Flatten()

Converte cada curva neste caminho numa sequência de segmentos de linha conexos.
Flatten(Matrix, Single)

Converte cada curva nesta GraphicsPath sequência de segmentos de linha conexos.
Flatten(Matrix)

Aplica a transformação especificada e depois converte cada curva nesta GraphicsPath numa sequência de segmentos de reta ligados.
GetBounds()

Devolve um retângulo que limita este GraphicsPath.
GetBounds(Matrix, Pen)

Devolve um retângulo que limita isto GraphicsPath quando o caminho atual é transformado pelo especificado Matrix e desenhado com o especificado Pen.
GetBounds(Matrix)

Devolve um retângulo que limita isto GraphicsPath quando este caminho é transformado pelo especificado Matrix.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetLastPoint()

Obtém o último ponto no PathPoints array deste GraphicsPath.
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)
IsOutlineVisible(Int32, Int32, Pen, Graphics)

Indica se o ponto especificado está contido dentro (abaixo) do contorno deste GraphicsPath quando desenhado com o especificado Pen e usando o especificado Graphics.
IsOutlineVisible(Int32, Int32, Pen)

Indica se o ponto especificado está contido dentro (abaixo) do contorno deste GraphicsPath quando desenhado com o especificado Pen.
IsOutlineVisible(Point, Pen, Graphics)

Indica se o ponto especificado está contido dentro (abaixo) do contorno deste GraphicsPath quando desenhado com o especificado Pen e usando o especificado Graphics.
IsOutlineVisible(Point, Pen)

Indica se o ponto especificado está contido dentro (abaixo) do contorno deste GraphicsPath quando desenhado com o especificado Pen.
IsOutlineVisible(PointF, Pen, Graphics)

Indica se o ponto especificado está contido dentro (abaixo) do contorno deste GraphicsPath quando desenhado com o especificado Pen e usando o especificado Graphics.
IsOutlineVisible(PointF, Pen)

Indica se o ponto especificado está contido dentro (abaixo) do contorno deste GraphicsPath quando desenhado com o especificado Pen.
IsOutlineVisible(Single, Single, Pen, Graphics)

Indica se o ponto especificado está contido dentro (abaixo) do contorno deste GraphicsPath quando desenhado com o especificado Pen e usando o especificado Graphics.
IsOutlineVisible(Single, Single, Pen)

Indica se o ponto especificado está contido dentro (abaixo) do contorno deste GraphicsPath quando desenhado com o especificado Pen.
IsVisible(Int32, Int32, Graphics)

Indica se o ponto especificado está contido neste GraphicsPath, usando o especificado Graphics.
IsVisible(Int32, Int32)

Indica se o ponto especificado está contido neste GraphicsPath.
IsVisible(Point, Graphics)

Indica se o ponto especificado está contido neste GraphicsPath.
IsVisible(Point)

Indica se o ponto especificado está contido neste GraphicsPath.
IsVisible(PointF, Graphics)

Indica se o ponto especificado está contido neste GraphicsPath.
IsVisible(PointF)

Indica se o ponto especificado está contido neste GraphicsPath.
IsVisible(Single, Single, Graphics)

Indica se o ponto especificado está contido dentro disto GraphicsPath na região de clipe visível do especificado Graphics.
IsVisible(Single, Single)

Indica se o ponto especificado está contido neste GraphicsPath.
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)
Reset()

Esvazia os PathPoints arrays e PathTypes define para FillModeAlternate.
Reverse()

Inverte a ordem dos pontos no PathPoints array deste GraphicsPath.
SetMarkers()

Define um marcador neste GraphicsPath.
StartFigure()

Começa uma nova figura sem fechar a atual. Todos os pontos subsequentes adicionados ao percurso são adicionados a esta nova figura.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
Transform(Matrix)

Aplica uma matriz de transformação a esta GraphicsPath.
Warp(PointF[], RectangleF, Matrix, WarpMode, Single)

Aplica uma transformada de dobra, definida por um retângulo e um paralelogramo, a este GraphicsPath.
Warp(PointF[], RectangleF, Matrix, WarpMode)

Aplica uma transformada de dobra, definida por um retângulo e um paralelogramo, a este GraphicsPath.
Warp(PointF[], RectangleF, Matrix)

Aplica uma transformada de dobra, definida por um retângulo e um paralelogramo, a este GraphicsPath.
Warp(PointF[], RectangleF)

Aplica uma transformada de dobra, definida por um retângulo e um paralelogramo, a este GraphicsPath.
Widen(Pen, Matrix, Single)

Substitui isto GraphicsPath por curvas que delimitam a área preenchida quando este caminho é desenhado pela caneta especificada.
Widen(Pen, Matrix)

Adiciona um esboço adicional ao GraphicsPath.
Widen(Pen)

Adiciona um contorno adicional ao percurso.

Aplica-se a

Ver também