AddBoxToPath

Vektorinė grafika, kelio apibrėžimas ir braižymas

Aprašymas

Prideda ašims lygiagretų stačiakampį kaip visiškai uždarą kelio fragmentą prie dabartinio kelio. Skirtingai nei AddLineToPath, šiai funkcijai nereikia iš anksto iškviesti StartPath — naujas kelio fragmentas pradedamas ir automatiškai uždaromas.

Sintaksė

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

Parametrai

Left	Stačiakampio kairiojo krašto horizontali koordinatė.
Top	Stačiakampio viršutinio krašto vertikali koordinatė.
Width	Stačiakampio plotis. Neigiami pločiai atspindimi, kad stačiakampio apimtis vis tiek būtų teigiama.
Height	Stačiakampio aukštis.

Grąžinamos reikšmės

0	Nepavyko — nėra atidaryto dokumento.
1	Stačiakampis pridėtas prie dabartinio kelio.

Pastabos

Prie to paties kelio galima pridėti kelis stačiakampius; kartu su DrawPathEvenOdd tai paprasčiausias būdas braižyti figūras su stačiakampėmis skylėmis. Pridėję visus stačiakampius, iškvieskite DrawPath (vyniojimo taisyklė) arba DrawPathEvenOdd (lyginio ir nelyginio taisyklė), kad nudažytumėte rezultatą.

Pavyzdys

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

Taip pat žiūrėkite

StartPath, AddLineToPath, AddArcToPath, DrawPath, DrawPathEvenOdd