AddBoxToPath

Vektorgrafika, útvonalmeghatározás és rajzolás

Leírás

Tengelyekkel párhuzamos téglalapot ad a teljes, zárt részútvonalként az aktuális útvonalhoz. Az AddLineToPath függvénytől eltérően ez a függvény nem igényel korábbi StartPath hívást — új részútvonal indul és automatikusan bezárul

Szintaxis

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);

Paraméterek

Left	A doboz bal szélének vízszintes koordinátája
Top	A doboz felső élének függőleges koordinátája
Width	A doboz szélessége. A negatív szélességek tükröződnek, ezért a téglalap kiterjedése továbbra is pozitív marad
Height	A mező magassága

Visszatérési értékek

0	Sikertelen — nincs megnyitott dokumentum
1	A téglalap hozzá lett adva az aktuális útvonalhoz

Megjegyzések

Ugyanahhoz az útvonalhoz több téglalap is hozzáadható; a DrawPathEvenOdd eljárással együtt ez a legegyszerűbb módja a téglalap alakú kivágásokkal rendelkező alakzatok rajzolásának. Az összes téglalap hozzáadása után az eredmény kirajzolásához hívja a DrawPath (kitöltési szabály) vagy a DrawPathEvenOdd (páratlan-páros szabály) eljárást

Példa

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

Lásd még

StartPath, AddLineToPath, AddArcToPath, DrawPath, DrawPathEvenOdd