AddBoxToPath

Grafică vectorială, Definirea și trasarea traseelor

Descriere

Adaugă un dreptunghi aliniat la axe ca sub-traseu închis complet pe traseul curent. Spre deosebire de AddLineToPath, această funcție nu cere un apel StartPath anterior — un sub-traseu proaspăt este pornit și închis automat

Sintaxă

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

Parametri

Left	Coordonata orizontală a marginii stângi a casetei
Top	Coordonata verticală a marginii superioare a casetei
Width	Lățimea casetei. Lățimile negative sunt reflectate, astfel încât dreptunghiul să aibă în continuare întindere pozitivă
Height	Înălțimea casetei

Valori returnate

0	Eșec — niciun document nu este deschis
1	Dreptunghiul a fost adăugat traseului curent

Observații

Pot fi adăugate mai multe casete aceluiași traseu; împreună cu DrawPathEvenOdd aceasta este cea mai simplă modalitate de a desena forme cu găuri dreptunghiulare. După adăugarea tuturor casetelor, apelați DrawPath (regula de înfășurare) sau DrawPathEvenOdd (regula par-impar) pentru a picta rezultatul

Exemplu

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

Consultați și

StartPath, AddLineToPath, AddArcToPath, DrawPath, DrawPathEvenOdd