ClosePath
Vectorafbeeldingen, paden definiëren en tekenen
Beschrijving
Sluit het huidige subpad van het pad dat door StartPath is gestart. Er wordt een rechte lijn getekend van het huidige punt terug naar het beginpunt van het pad, zodat de figuur één gesloten vorm is in plaats van twee eindpunten die alleen door een lijnverbinding zijn verbonden. ClosePath aanroepen tekent het pad niet — roep daarna DrawPath of DrawPathEvenOdd aan om het te omlijnen en/of te vullen
Syntaxis
Delphi
Function TPDFlib.ClosePath: Integer;
ActiveX
Function PDFlib::ClosePath() As Long
DLL
int DLClosePath(int InstanceID);
Retourwaarden
| 0 | Failed — no document is open or no path has been started. |
|---|---|
| 1 | Het huidige subpad is gesloten |
Opmerkingen
Het pad sluiten is belangrijk zodra de vorm wordt omlijnd: een open pad laat een zichtbaar gat tussen het laatste punt en het eerste punt, en de lijnverbinding op dat hoekpunt wordt gerenderd als butt cap in plaats van een echte lijnverbinding. Voor gevulde paden volgt de sluitlijn impliciet uit de vulregel, maar expliciet sluiten levert nog steeds nettere uitvoer op en is vereist voordat met een nieuwe StartPath een nieuw subpad wordt begonnen
Voorbeeld
// 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 onlyZie ook
StartPath, AddLineToPath, AddCurveToPath, DrawPath, DrawPathEvenOdd