ClosePath

Gráficos vetoriais, Definição e desenho de caminhos

Descrição

Fecha o sub-path atual do path iniciado por StartPath. Uma linha reta é traçada do ponto atual de volta ao ponto inicial do path, garantindo que a figura seja uma única forma fechada e não dois pontos finais conectados apenas por um traço. Chamar ClosePath não pinta o path — chame DrawPath ou DrawPathEvenOdd depois para traçar e/ou preencher.

Sintaxe

Delphi

Function TPDFlib.ClosePath: Integer;

ActiveX

Function PDFlib::ClosePath() As Long

DLL

int DLClosePath(int InstanceID);

Valores retornados

0Failed — no document is open or no path has been started.
1O sub-path atual foi fechado.

Observações

Fechar o path é importante sempre que a forma receberá traço: um path aberto deixa uma lacuna visível entre o último ponto e o primeiro, e a junção do traço nesse vértice é renderizada como uma ponta reta (butt cap) em vez de uma junção de linha apropriada. Para paths preenchidos, a linha de fechamento fica implícita na regra de preenchimento, mas fechar explicitamente ainda produz uma saída mais limpa e é exigido antes de iniciar um novo sub-path com outro StartPath.

Exemplo

// Draw a closed triangle, stroked
PDF.SetStrokeColor(0, 0, 0);
PDF.SetLineWidth(1);
PDF.StartPath(100, 100);
PDF.AddLineToPath(200, 100);
PDF.AddLineToPath(150, 180);
PDF.ClosePath;          // line back to (100, 100)
PDF.DrawPath(0);        // 0 = outline only

Veja também

StartPath, AddLineToPath, AddCurveToPath, DrawPath, DrawPathEvenOdd