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	عرض کادر. عرض‌های منفی آینه می‌شوند تا مستطیل همچنان وسع مثبت داشته باشد
Height	ارتفاع جعبه

مقادیر بازگشتی

0	ناموفق — هیچ سندی باز نیست
1	مستطیل به مسیر جاری اضافه شد

ملاحظات

می‌توان چند کادر را به همان مسیر افزود؛ همراه DrawPathEvenOdd ساده‌ترین راه رسم شکل‌های با سوراخ مستطیلی است. بعد از افزودن همهٔ کادرها برای رنگ‌آمیز کردن نتیجه DrawPath (قاعدهٔ پیچش) یا DrawPathEvenOdd (قاعدهٔ even-odd) را فراخوانی کنید

مثال

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