AddBoxToPath

Vektorgrafik, stidefinition og tegning

Beskrivelse

Føjer et aksejusteret rektangel til den aktuelle sti som en komplet lukket understi. I modsætning til AddLineToPath kræver funktionen ikke et tidligere kald til StartPath — en ny understi 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);

Parametre

Left	Den vandrette koordinat for boksens venstre kant
Top	Den lodrette koordinat for boksens øverste kant.
Width	Boksens bredde. Negative bredder spejles, så rektanglet stadig har en positiv udstrækning.
Height	Boksens højde.

Returværdier

0	Mislykkedes — intet dokument er åbent
1	Rektanglet blev tilføjet den aktuelle sti.

Bemærkninger

Flere bokse kan føjes til den samme sti; sammen med DrawPathEvenOdd er dette den enkleste måde at tegne figurer med rektangulære huller på. Når alle bokse er tilføjet, skal du kalde DrawPath (viklingsregel) eller DrawPathEvenOdd (lige-ulige-regel) for at tegne 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