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 (правило обертання) чи 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