AddBoxToPath

Vectorafbeeldingen, paden definiëren en tekenen

Beschrijving

Voegt een asuitgelijnde rechthoek als volledig gesloten subpad toe aan het huidige pad. Anders dan AddLineToPath vereist deze functie geen voorafgaande aanroep van StartPath — er wordt automatisch een nieuw subpad gestart en gesloten

Syntaxis

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

Parameters

Left	De horizontale coördinaat van de linkerrand van de box
Top	De verticale coördinaat van de bovenrand van de box
Width	De breedte van de box. Negatieve breedtes worden gespiegeld, zodat de rechthoek nog steeds een positieve omvang heeft
Height	De hoogte van de box.

Retourwaarden

0	Failed — no document is open.
1	De rechthoek is aan het huidige pad toegevoegd

Opmerkingen

Er kunnen meerdere boxen aan hetzelfde pad worden toegevoegd; samen met DrawPathEvenOdd is dit de eenvoudigste manier om vormen met rechthoekige gaten te tekenen. Zijn alle boxen toegevoegd, roep dan DrawPath (winding-regel) of DrawPathEvenOdd (even-odd-regel) aan om het resultaat te tekenen

Voorbeeld

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

Zie ook

StartPath, AddLineToPath, AddArcToPath, DrawPath, DrawPathEvenOdd