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
| 0 | Failed — no document is open or no path has been started. |
|---|---|
| 1 | O 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 onlyVeja também
StartPath, AddLineToPath, AddCurveToPath, DrawPath, DrawPathEvenOdd