AddBoxToPath

Vector graphics, Path definition and drawing

Description

Aggiunge un rettangolo allineato agli assi come sotto-tracciato chiuso completo al tracciato corrente; a differenza di AddLineToPath, questa funzione non richiede una precedente chiamata a StartPath: un nuovo sotto-tracciato viene avviato e chiuso automaticamente

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	La coordinata orizzontale del bordo sinistro della casella
Top	La coordinata verticale del bordo superiore della casella
Width	La larghezza della casella; le larghezze negative sono riflesse in modo che il rettangolo mantenga comunque un'estensione positiva
Height	L'altezza della casella

Return values

0	Non riuscito — nessun documento è aperto
1	Il rettangolo è stato aggiunto al percorso corrente

Remarks

È possibile aggiungere più caselle allo stesso percorso; insieme a DrawPathEvenOdd questo è il modo più semplice per disegnare forme con fori rettangolari; dopo che tutte le caselle sono state aggiunte, chiamare DrawPath (regola winding) o DrawPathEvenOdd (regola even-odd) per dipingere il risultato

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