AddBoxToPath

Векторна графика, Определяне и рисуване на път

Описание

Добавя правоъгълник, подравнен по осите, като цяла затворена подпътека към текущия път. За разлика от AddLineToPath, тази функция не изисква предварително извикване на StartPath — нова подпътека се започва и затваря автоматично

Синтаксис

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

Параметри

Left	Хоризонталната координата на лявия ръб на правоъгълника
Top	Вертикалната координата на горния ръб на правоъгълника
Width	Ширината на правоъгълника. Отрицателните ширини се отразяват така, че правоъгълникът да запази положително разпъване
Height	Височината на правоъгълника

Върнати стойности

0	Неуспех — няма отворен документ
1	Правоъгълникът е добавен към текущия път

Забележки

Няколко кутии могат да бъдат добавени към един и същ път; заедно с DrawPathEvenOdd това е най-простият начин да рисувате фигури с правоъгълни отвори. След като всички кутии бъдат добавени, извикайте DrawPath (правило winding) или DrawPathEvenOdd (правило even-odd), за да изобразите резултата

Пример

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

Вижте също

StartPath, AddLineToPath, AddArcToPath, DrawPath, DrawPathEvenOdd