AddBoxToPath

Vektorgrafik, Bandefinition och ritning

Beskrivning

Lägger till en axelriktad rektangel som en komplett stängd sub-path till aktuellt path. I motsats till AddLineToPath kräver den här funktionen inget tidigare StartPath-anrop — en färsk sub-path startas och stängs automatiskt

Syntax

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

Parametrar

Left	Boxens vänsterkants horisontella koordinat
Top	Boxens överkants vertikala koordinat
Width	Boxens bredd. Negativa bredder speglas så att rektangeln fortfarande har positiv utsträckning
Height	Boxens höjd

Returvärden

0	Misslyckades — inget dokument är öppet
1	Rektangeln lades till aktuellt path

Anmärkningar

Flera boxar kan läggas till samma path; tillsammans med DrawPathEvenOdd är detta det enklaste sättet att rita former med rektangulära hål. När alla boxar lagts till, anropa DrawPath (winding-regeln) eller DrawPathEvenOdd (even-odd-regeln) för att måla resultatet

Exempel

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

StartPath, AddLineToPath, AddArcToPath, DrawPath, DrawPathEvenOdd