AddBoxToPath

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

الوصف

يضيف مستطيلًا متحاذيًا مع المحاور كمشوار فرعي مغلق كاملًا إلى المسار الحالي. وعلى خلاف AddLineToPath لا تتطلب هذه الدالة استدعاء StartPath مسبقًا — يبدأ مشوار فرعي جديد ويُغلق تلقائيًا

الصيغة

Delphi

Function TPDFlib.AddBoxToPath(Left, Top, Width, Height: Double): Integer;

ActiveX

Function PDFlib::AddBoxToPath(Left As Double, Top As Double, Width As Double, Height As Double) As Long

DLL

int DLAddBoxToPath(int InstanceID, double Left, double Top, double Width, double Height);

المعاملات

Leftالإحداثي الأفقي للحافة اليسرى للصندوق
Topالإحداثي الرأسي للحافة العلوية للصندوق
Widthعرض الصندوق. وتنعكس العروض السالبة فيبقى للمستطيل
HeightThe height of the box.

قيم الإرجاع

0فشل — لا يوجد مستند مفتوح
1أُضيف المستطيل إلى المسار الحالي

ملاحظات

يمكن إضافة عدة صناديق إلى المسار نفسه؛ ومع DrawPathEvenOdd فهذه أبسط طريقة لرسم أشكال بثقوب مستطيلة. وبعد إضافة جميع الصناديق استدعِ DrawPath ‏(قاعدة اللف) أو DrawPathEvenOdd ‏(قاعدة الزوجي-الفردي) لرسم النتيجة

مثال

// A filled rectangle frame: outer box with an inner box punched out
PDF.SetFillColor(0.2, 0.4, 0.8);
PDF.AddBoxToPath(100, 100, 200, 120);  // outer
PDF.AddBoxToPath(120, 120, 160,  80);  // inner cut-out
PDF.DrawPathEvenOdd(1);                // 1 = fill

انظر أيضا

StartPath, AddLineToPath, AddArcToPath, DrawPath, DrawPathEvenOdd