AddBoxToPath

Vektorgrafikk, Banedefinisjon og tegning

Beskrivelse

Legger til et akseparallelt rektangel som en komplett lukket delbane til gjeldende bane. I motsetning til AddLineToPath krever ikke denne funksjonen et forutgående StartPath-kall — en fersk delbane startes og lukkes automatisk

Syntaks

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

Parametere

Left	Den horisontale koordinaten til boksens venstre kant
Top	Den vertikale koordinaten til boksens øvre kant
Width	Boksens bredde. Negative bredder speiles slik at rektangelet fortsatt har positiv utstrekning
Height	Boksens høyde

Returverdier

0	Failed — no document is open.
1	Rektangelet ble lagt til gjeldende bane

Merknader

Flere bokser kan legges til samme bane; sammen med DrawPathEvenOdd er dette den enkleste måten å tegne former med rektangulære hull på. Etter at alle boksene er lagt til, kall DrawPath (winding-regelen) eller DrawPathEvenOdd (even-odd-regelen) for å male resultatet

Eksempel

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

Se også

StartPath, AddLineToPath, AddArcToPath, DrawPath, DrawPathEvenOdd