AddBoxToPath

Vektorová grafika, Definícia ciest a kreslenie

Opis

Pridá obdĺžnik zarovnaný s osami ako kompletný uzavretý sub-path do aktuálneho pathu. Na rozdiel od AddLineToPath táto funkcia nevyžaduje predchádzajúce volanie StartPath — nový sub-path sa automaticky spustí a uzavrie.

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

Parametre

Left	Vodorovná súradnica ľavej hrany obdĺžnika.
Top	Zvislá súradnica hornej hrany obdĺžnika.
Width	Šírka obdĺžnika. Záporné šírky sa zrkadlia, takže obdĺžnik má aj tak kladný rozsah.
Height	The height of the box.

Návratové hodnoty

0	Failed — no document is open.
1	Obdĺžnik sa pridal do aktuálnej cesty.

Poznámky

Do tej istej cesty možno pridať viac obdĺžnikov; spolu s DrawPathEvenOdd je to najjednoduchší spôsob, ako kresliť tvary s obdĺžnikovými otvormi. Po pridaní všetkých obdĺžnikov zavolajte DrawPath (pravidlo obehov) alebo DrawPathEvenOdd (pravidlo pár-nejpár), aby sa výsledok vykreslil.

Príklad

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

Pozri tiež

StartPath, AddLineToPath, AddArcToPath, DrawPath, DrawPathEvenOdd