AddBoxToPath

Vector graphics, Path definition and drawing

Description

Добавляет выровненный по осям прямоугольник как полный замкнутый подконтур к текущему контуру; в отличие от AddLineToPath, эта функция не требует предварительного вызова StartPath — новый подконтур запускается и закрывается автоматически

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

Parameters

Left	Горизонтальная координата левого края прямоугольника
Top	Вертикальная координата верхнего края прямоугольника
Width	Ширина прямоугольника; отрицательная ширина отражается так, чтобы прямоугольник по-прежнему имел положительный размер
Height	Высота прямоугольника

Return values

0	Ошибка — документ не открыт
1	Прямоугольник был добавлен к текущему контуру

Remarks

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

Example

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