ClosePath

رسومات المتجهات، تعريف المسارات ورسمها

الوصف

يغلق المشوار الفرعي الحالي للمسار الذي بدأته StartPath. يُرسم خط مستقيم من النقطة الحالية عائدًا إلى نقطة بداية المسار، فيصبح الشكل شكلًا مغلقًا واحدًا بدلًا من نقطتي نهاية متصلتين بوصلة رسم فقط. واستدعاء ClosePath لا يرسم المسار — استدعِ DrawPath أو DrawPathEvenOdd بعده لرسم حدوده و/أو تعبئته

الصيغة

Delphi

Function TPDFlib.ClosePath: Integer;

ActiveX

Function PDFlib::ClosePath() As Long

DLL

int DLClosePath(int InstanceID);

قيم الإرجاع

0فشل — لا يوجد مستند مفتوح أو لم يبدأ أي مسار
1أُغلق المشوار الفرعي الحالي

ملاحظات

إغلاق المسار مهم كلما سيرسم الشكل بحدود: يترك المسار المفتوح فجوة مرئية بين آخر نقطة وأول نقطة، وتُرسم وصلة الحد عند تلك الرأس كنهاية مسطحة بدلًا من وصلة خط سليمة. وفي المسارات المعبأة يضمنه قاعدة التعبئة ضمنيًا، لكن الإغلاق الصريح ما يزال ينتج إخراجًا أنظف وهو مطلوب قبل بدء مشوار فرعي جديد بـ StartPath أخرى

مثال

// 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

انظر أيضا

StartPath, AddLineToPath, AddCurveToPath, DrawPath, DrawPathEvenOdd