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	The height of the box.

Возвращаемые значения

0	Failed — no document is open.
1	Прямоугольник добавлен в текущий контур

Примечания

В один контур можно добавить несколько прямоугольников; вместе с DrawPathEvenOdd это простейший способ нарисовать фигуры с прямоугольными отверстиями. После добавления всех прямоугольников вызовите DrawPath (правило намотки) или DrawPathEvenOdd (правило четности), чтобы нарисовать результат

Пример

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