GraphicsPath Classe

Definição

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Assembly:

System.Drawing.dll

Representa uma série de linhas e curvas conectadas. Essa 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

Comentários

Observação

No .NET 6 e em versões posteriores, o pacote System.Drawing.Common, que inclui esse tipo, só tem suporte em sistemas Windows operacionais. O uso desse tipo em aplicativos de plataforma cruzada causa avisos de tempo de compilação e exceções de tempo de run-time. Para obter mais informações, consulte System.Drawing.Common com suporte apenas no Windows.

Os aplicativos usam caminhos para desenhar contornos de formas, preencher os interiores das formas e criar regiões de recorte. O mecanismo gráfico mantém as coordenadas de formas geométricas em um caminho 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 um primitivo de forma geométrica. O ponto de partida de uma figura é o primeiro ponto na sequência de linhas e curvas conectadas. O ponto final é o último ponto na sequência. Os pontos iniciais e finais de um primitivo de forma geométrica são definidos pela especificação primitiva.

Uma figura que consiste em uma sequência de linhas e curvas conectadas (cujos pontos iniciais e finais podem ser coincidentes) é 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 conectando uma linha do ponto final ao ponto de partida. Uma figura que consiste em um primitivo de forma geométrica é uma figura fechada.

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

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

Quando um primitivo de forma geométrica é adicionado a um caminho, ele adiciona uma figura que contém a forma geométrica e também inicia implicitamente uma nova figura. Consequentemente, há sempre uma figura atual em um caminho. Quando linhas e curvas são adicionadas a um caminho, uma linha implícita é adicionada conforme necessário para conectar o ponto final da figura atual ao ponto de partida das novas linhas e curvas para formar uma sequência de linhas e curvas conectadas.

Uma figura tem uma direção que descreve como os segmentos de linha e curva são rastreados entre o ponto inicial e o ponto final. A direção é definida na ordem em que linhas e curvas são adicionadas a uma figura ou é definida pelo primitivo da forma geométrica. A direção é usada para determinar os interiores do caminho para recorte e preenchimento.

Construtores

GraphicsPath()	Inicializa uma nova instância da classe GraphicsPath com um valor FillMode de Alternate.
GraphicsPath(FillMode)	Inicializa uma nova instância da classe GraphicsPath com a enumeração FillMode especificada.
GraphicsPath(Point[], Byte[])	Inicializa uma nova instância da classe GraphicsPath com as matrizes PathPointType e Point especificadas.
GraphicsPath(Point[], Byte[], FillMode)	Inicializa uma nova instância da classe GraphicsPath com as matrizes PathPointType e Point especificadas e com o elemento de enumeração FillMode especificado.
GraphicsPath(PointF[], Byte[])	Inicializa uma nova instância da matriz GraphicsPath com as matrizes PathPointType e PointF especificadas.
GraphicsPath(PointF[], Byte[], FillMode)	Inicializa uma nova instância da matriz GraphicsPath com as matrizes PathPointType e PointF especificadas e com o elemento de enumeração FillMode especificado.

Propriedades

FillMode	Obtém ou define uma enumeração FillMode que determina como os interiores das formas neste GraphicsPath são preenchidos.
PathData	Obtém um PathData que encapsula matrizes de pontos (points) e tipos (types) para este GraphicsPath.
PathPoints	Obtém os pontos no caminho.
PathTypes	Obtém os tipos dos pontos correspondentes na matriz PathPoints.
PointCount	Obtém o número de elementos na PathPoints ou na matriz PathTypes.

Métodos

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 de Bézier cúbica à figura atual.
AddBezier(Point, Point, Point, Point)	Adiciona uma curva de Bézier cúbica à figura atual.
AddBezier(PointF, PointF, PointF, PointF)	Adiciona uma curva de Bézier cúbica à figura atual.
AddBezier(Single, Single, Single, Single, Single, Single, Single, Single)	Adiciona uma curva de Bézier cúbica à figura atual.
AddBeziers(Point[])	Adiciona à figura atual uma sequência de curvas de Bézier cúbicas conectadas.
AddBeziers(PointF[])	Adiciona à figura atual uma sequência de curvas de Bézier cúbicas conectadas.
AddClosedCurve(Point[])	Adiciona uma curva fechada a esse caminho. Uma curva de spline cardinal é usada porque a curva percorre cada um dos pontos da matriz.
AddClosedCurve(Point[], Single)	Adiciona uma curva fechada a esse caminho. Uma curva de spline cardinal é usada porque a curva percorre cada um dos pontos da matriz.
AddClosedCurve(PointF[])	Adiciona uma curva fechada a esse caminho. Uma curva de spline cardinal é usada porque a curva percorre cada um dos pontos da matriz.
AddClosedCurve(PointF[], Single)	Adiciona uma curva fechada a esse caminho. Uma curva de spline cardinal é usada porque a curva percorre cada um dos pontos da matriz.
AddCurve(Point[])	Adiciona uma curva de spline à figura atual. Uma curva de spline cardinal é usada porque a curva percorre cada um dos pontos da matriz.
AddCurve(Point[], Int32, Int32, Single)	Adiciona uma curva de spline à figura atual.
AddCurve(Point[], Single)	Adiciona uma curva de spline à figura atual.
AddCurve(PointF[])	Adiciona uma curva de spline à figura atual. Uma curva de spline cardinal é usada porque a curva percorre cada um dos pontos da matriz.
AddCurve(PointF[], Int32, Int32, Single)	Adiciona uma curva de spline à figura atual.
AddCurve(PointF[], Single)	Adiciona uma curva de spline à figura atual.
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 para a figura atual.
AddLine(Point, Point)	Acrescenta um segmento de linha para esse GraphicsPath.
AddLine(PointF, PointF)	Acrescenta um segmento de linha para esse GraphicsPath.
AddLine(Single, Single, Single, Single)	Acrescenta um segmento de linha para esse GraphicsPath.
AddLines(Point[])	Acrescenta uma série de segmentos de linha conectados ao final deste GraphicsPath.
AddLines(PointF[])	Acrescenta uma série de segmentos de linha conectados ao final deste GraphicsPath.
AddPath(GraphicsPath, Boolean)	Acrescenta o GraphicsPath especificado a esse caminho.
AddPie(Int32, Int32, Int32, Int32, Single, Single)	Adiciona a estrutura de tópicos de uma forma de pizza a esse caminho.
AddPie(Rectangle, Single, Single)	Adiciona a estrutura de tópicos de uma forma de pizza a esse caminho.
AddPie(Single, Single, Single, Single, Single, Single)	Adiciona a estrutura de tópicos de uma forma de pizza a esse caminho.
AddPolygon(Point[])	Adiciona um polígono a esse caminho.
AddPolygon(PointF[])	Adiciona um polígono a esse caminho.
AddRectangle(Rectangle)	Adiciona um retângulo a esse caminho.
AddRectangle(RectangleF)	Adiciona um retângulo a esse 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 nesse caminho.
AddString(String, FontFamily, Int32, Single, PointF, StringFormat)	Adiciona uma cadeia de texto nesse caminho.
AddString(String, FontFamily, Int32, Single, Rectangle, StringFormat)	Adiciona uma cadeia de texto nesse caminho.
AddString(String, FontFamily, Int32, Single, RectangleF, StringFormat)	Adiciona uma cadeia de texto nesse caminho.
ClearMarkers()	Limpa todos os marcadores desse caminho.
Clone()	Cria uma cópia exata desse caminho.
CloseAllFigures()	Fecha todos os valores nesse caminho e inicia uma nova figura. Ele fecha cada figura aberta conectando uma linha de seu ponto de extremidade a seu ponto inicial.
CloseFigure()	Fecha a figura atual e inicia uma nova figura. Se a figura atual contiver uma sequência de linhas e curvas conectadas, o método fechará o loop conectando uma linha do ponto de extremidade ao ponto de partida.
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 este GraphicsPath.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Finalize()	Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes de ser recuperado pela coleta de lixo.
Flatten()	Converte cada curva neste caminho em uma sequência de segmentos de linha conectados.
Flatten(Matrix)	Aplica a transformação especificada e então converte cada curva neste GraphicsPath em uma sequência de segmentos de linha conectados.
Flatten(Matrix, Single)	Converte cada curva neste GraphicsPath em uma sequência de segmentos de linha conectados.
GetBounds()	Retorna um retângulo que circunda esse GraphicsPath.
GetBounds(Matrix)	Retorna um retângulo que delimita este GraphicsPath quando este caminho é transformado pelo Matrix especificado.
GetBounds(Matrix, Pen)	Retorna um retângulo que delimita este GraphicsPath quando o caminho atual é transformado pelo Matrix especificado e desenhado com a Pen especificada.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLastPoint()	Obtém o último ponto na matriz PathPoints deste GraphicsPath.
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)
IsOutlineVisible(Int32, Int32, Pen)	Indica se o ponto especificado está contido dentro de (sob) o contorno deste GraphicsPath quando desenhado com a Pen especificada.
IsOutlineVisible(Int32, Int32, Pen, Graphics)	Indica se o ponto especificado está contido dentro de (sob) o contorno deste GraphicsPath quando desenhado com a Pen especificada e usando o Graphics especificado.
IsOutlineVisible(Point, Pen)	Indica se o ponto especificado está contido dentro de (sob) o contorno deste GraphicsPath quando desenhado com a Pen especificada.
IsOutlineVisible(Point, Pen, Graphics)	Indica se o ponto especificado está contido dentro de (sob) o contorno deste GraphicsPath quando desenhado com a Pen especificada e usando o Graphics especificado.
IsOutlineVisible(PointF, Pen)	Indica se o ponto especificado está contido dentro de (sob) o contorno deste GraphicsPath quando desenhado com a Pen especificada.
IsOutlineVisible(PointF, Pen, Graphics)	Indica se o ponto especificado está contido dentro de (sob) o contorno deste GraphicsPath quando desenhado com a Pen especificada e usando o Graphics especificado.
IsOutlineVisible(Single, Single, Pen)	Indica se o ponto especificado está contido dentro de (sob) o contorno deste GraphicsPath quando desenhado com a Pen especificada.
IsOutlineVisible(Single, Single, Pen, Graphics)	Indica se o ponto especificado está contido dentro de (sob) o contorno deste GraphicsPath quando desenhado com a Pen especificada e usando o Graphics especificado.
IsVisible(Int32, Int32)	Indica se o ponto especificado está contido neste GraphicsPath.
IsVisible(Int32, Int32, Graphics)	Indica se o ponto especificado está contido neste GraphicsPath, usando o Graphics especificado.
IsVisible(Point)	Indica se o ponto especificado está contido neste GraphicsPath.
IsVisible(Point, Graphics)	Indica se o ponto especificado está contido neste GraphicsPath.
IsVisible(PointF)	Indica se o ponto especificado está contido neste GraphicsPath.
IsVisible(PointF, Graphics)	Indica se o ponto especificado está contido neste GraphicsPath.
IsVisible(Single, Single)	Indica se o ponto especificado está contido neste GraphicsPath.
IsVisible(Single, Single, Graphics)	Indica se o ponto especificado está contido neste GraphicsPath, na região de recorte visível do Graphics especificado.
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)
Reset()	Esvazia as matrizes PathPoints e PathTypes e define o FillMode como Alternate.
Reverse()	Inverte a ordem dos pontos na matriz PathPoints desse GraphicsPath.
SetMarkers()	Define um marcador neste GraphicsPath.
StartFigure()	Inicia uma nova figura sem fechar a figura atual. Todos os pontos subsequentes adicionados ao caminho são adicionados a essa nova figura.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
Transform(Matrix)	Aplica a uma matriz de transformação a este GraphicsPath.
Warp(PointF[], RectangleF)	Aplica uma transformação de distorção, definida por um retângulo e um paralelogramo, a este GraphicsPath.
Warp(PointF[], RectangleF, Matrix)	Aplica uma transformação de distorção, definida por um retângulo e um paralelogramo, a este GraphicsPath.
Warp(PointF[], RectangleF, Matrix, WarpMode)	Aplica uma transformação de distorção, definida por um retângulo e um paralelogramo, a este GraphicsPath.
Warp(PointF[], RectangleF, Matrix, WarpMode, Single)	Aplica uma transformação de distorção, definida por um retângulo e um paralelogramo, a este GraphicsPath.
Widen(Pen)	Adiciona um contorno adicional ao caminho.
Widen(Pen, Matrix)	Adiciona um contorno adicional ao GraphicsPath.
Widen(Pen, Matrix, Single)	Substitui este GraphicsPath por curvas que circunscrevem a área preenchida quando esse caminho é desenhado pela caneta especificada.

Confira também

• Construindo e desenhando demarcadores