AddBoxToPath

Vector graphics, Path definition and drawing

Description

Voegt een assen-uitgelijnde rechthoek toe als een compleet gesloten subpad aan het huidige pad; in tegenstelling tot AddLineToPath vereist deze functie geen voorafgaande aanroep van StartPath — een nieuw subpad wordt automatisch gestart en gesloten

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

Parameters

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

Return values

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

Remarks

Er kunnen meerdere kaders aan hetzelfde pad worden toegevoegd; samen met DrawPathEvenOdd is dit de eenvoudigste manier om vormen met rechthoekige gaten te tekenen; roep, nadat alle kaders zijn toegevoegd, DrawPath (windingregel) of DrawPathEvenOdd (even-odd-regel) aan om het resultaat in te kleuren

Example

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