AddBoxToPath

Vektorigrafiikka, polkujen määrittely ja piirto

Kuvaus

Lisää akselisuuntaisen suorakulmion täydellisenä suljettuna alipolkuna nykyiseen polkuun. Toisin kuin AddLineToPath, tämä funktio ei vaadi aiempaa StartPath-kutsua — tuore alipolku avataan ja suljetaan automaattisesti

Syntaksi

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

Parametrit

Left	Laatikon vasemman reunan vaakakoordinaatti
Top	Laatikon yläreunan pystykoordinaatti
Width	Laatikon leveys. Negatiiviset leveydet peilaavat, jolloin suorakulmiolla on silti positiivinen laajuus
Height	The height of the box.

Paluuarvot

0	Epäonnistui — mikään asiakirja ei ole avoinna
1	Suorakulmio lisättiin nykyiseen polkuun

Huomautukset

Samaan polkuun voi lisätä useita laatikoita; yhdessä DrawPathEvenOddn kanssa tämä on yksinkertaisin tapa piirtää muotoja, joissa on suorakulmaisia aukkoja. Kaikkien laatikoiden lisäämisen jälkeen kutsu DrawPathia (kiertosääntö) tai DrawPathEvenOddia (pariton-parillinen-sääntö) maalataksesi tuloksen

Esimerkki

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

Katso myös

StartPath, AddLineToPath, AddArcToPath, DrawPath, DrawPathEvenOdd