AddBoxToPath

Vector graphics, Path definition and drawing

Description

Ajoute un rectangle aligné sur les axes comme un sous-tracé (sub-path) fermé complet au tracé actuel ; contrairement à AddLineToPath, cette fonction ne requiert pas d'appel préalable à StartPath — un nouveau sous-tracé est démarré et fermé automatiquement

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	The horizontal co-ordinate of the box's left edge.
Top	The vertical co-ordinate of the box's top edge.
Width	The width of the box. Negative widths are reflected so the rectangle still has positive extent.
Height	The height of the box.

Return values

0	Failed — no document is open.
1	The rectangle was added to the current path.

Remarks

Several boxes can be added to the same path; together with DrawPathEvenOdd this is the simplest way to draw shapes with rectangular holes. After all boxes are added, call DrawPath (winding rule) or DrawPathEvenOdd (even-odd rule) to paint the result.

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