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 (כלל winding) או ל-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