AddLineToPath

גרפיקה וקטורית, הגדרת נתיבים וציור

תיאור

מוסיפה קו ישר לנתיב הנוכחי, מהנקודה הנוכחית של הנתיב לנקודה החדשה ב-(EndX, EndY). לאחר מכן הנקודה הנוכחית עוברת אל (EndX, EndY), כך שפרימיטיב הנתיב הבא ממשיך משם

תחביר

Delphi

Function TPDFlib.AddLineToPath(EndX, EndY: Double): Integer;

ActiveX

Function PDFlib::AddLineToPath(EndX As Double, EndY As Double) As Long

DLL

int DLAddLineToPath(int InstanceID, double EndX, double EndY);

פרמטרים

EndXהקואורדינטה האופקית של נקודת הסיום של הקו
EndYהקואורדינטה האנכית של נקודת הסיום של הקו

ערכי החזרה

0נכשל — אין מסמך פתוח או שאף נתיב לא הותחל עם StartPath.
1מקטע הקו נוסף למסלול הנוכחי

הערות

קראו ל-StartPath לפני ה-AddLineToPath הראשון כדי לקבוע את נקודת ההתחלה של הנתיב. אחרי שהנתיב הורכב במלואו, קראו ל-DrawPath או ל-DrawPathEvenOdd כדי לצייר אותו. השתמשו ב-ClosePath כדי לצייר מקטע סיום חזרה אל נקודת ההתחלה.

דוגמה

// A zig-zag polyline
PDF.SetStrokeColor(0, 0, 0);
PDF.SetLineWidth(1);
PDF.StartPath(50, 100);
PDF.AddLineToPath(100, 150);
PDF.AddLineToPath(150, 100);
PDF.AddLineToPath(200, 150);
PDF.AddLineToPath(250, 100);
PDF.DrawPath(0);                       // 0 = outline only

ראו גם

StartPath, AddCurveToPath, AddArcToPath, AddBoxToPath, ClosePath, DrawPath