AddBoxToPath

Vektorová grafika, definice a kreslení cest

Popis

Přidá obdélník zarovnaný s osami jako kompletní uzavřenou podcestu do aktuální cesty. Na rozdíl od AddLineToPath tato funkce nevyžaduje předchozí volání StartPath — nová podcesta se automaticky zahájí a uzavře.

Syntaxe

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

Parametry

Left	Vodorovná souřadnice levé hrany boxu
Top	Svislá souřadnice horní hrany boxu
Width	Šířka boxu. Záporné šířky se zrcadlí, takže obdélník má i tak kladný rozsah
Height	The height of the box.

Návratové hodnoty

0	Failed — no document is open.
1	Obdélník se přidal do aktuální cesty

Poznámky

Do téže cesty lze přidat více boxů; spolu s DrawPathEvenOdd je to nejjednodušší způsob kreslení tvarů s obdélníkovými dírami. Po přidání všech boxů zavolejte DrawPath (pravidlo winding) nebo DrawPathEvenOdd (pravidlo even-odd), abyste výsledek vybarvili

Pří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

Viz také

StartPath, AddLineToPath, AddArcToPath, DrawPath, DrawPathEvenOdd