AddBoxToPath

Grafika wektorowa, Definiowanie i rysowanie ścieżek

Opis

Dodaje prostokąt zgodny z osiami jako kompletną, zamkniętą podścieżkę bieżącej ścieżki. W przeciwieństwie do AddLineToPath ta funkcja nie wymaga wcześniejszego wywołania StartPath — nowa podścieżka jest rozpoczynana i zamykana automatycznie

Składnia

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	Współrzędna pozioma lewej krawędzi prostokąta
Top	Współrzędna pionowa górnej krawędzi prostokąta
Width	Szerokość prostokąta. Ujemne szerokości są odbijane, dzięki czemu prostokąt nadal ma dodatni zasięg
Height	Wysokość prostokąta

Wartości zwracane

0	Niepowodzenie — nie otwarto dokumentu
1	Prostokąt został dodany do bieżącej ścieżki

Uwagi

Do tej samej ścieżki można dodać kilka prostokątów; w połączeniu z DrawPathEvenOdd jest to najprostszy sposób rysowania kształtów z prostokątnymi otworami. Po dodaniu wszystkich prostokątów wywołaj DrawPath (reguła nawijania) lub DrawPathEvenOdd (reguła parzystości), aby narysować wynik

Przykład

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

Zobacz również

StartPath, AddLineToPath, AddArcToPath, DrawPath, DrawPathEvenOdd