AddBoxToPath

Đồ họa vector, Định nghĩa và vẽ đường dẫn

Mô tả

Thêm hình chữ nhật thẳng theo trục vào path hiện tại dưới dạng một sub-path đóng hoàn chỉnh. Khác AddLineToPath, hàm này không cần gọi StartPath trước – sub-path mới được mở và đóng tự động.

Cú pháp

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

Tham số

Left	Tọa độ ngang của cạnh trái box
Top	Tọa độ dọc của cạnh trên box
Width	Chiều rộng của box. Chiều rộng âm bị phản chiếu nên hình chữ nhật vẫn có kích thước dương
Height	Chiều cao của box.

Giá trị trả về

0	Failed — no document is open.
1	Hình chữ nhật đã được thêm vào path hiện tại

Ghi chú

Có thể thêm nhiều box vào cùng một path; kết hợp với DrawPathEvenOdd đây là cách đơn giản nhất để vẽ các hình có lỗ chữ nhật. Sau khi thêm hết các box, gọi DrawPath (quy tắc winding) hay DrawPathEvenOdd (quy tắc even-odd) để tô kết quả

Ví dụ

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

Xem thêm

StartPath, AddLineToPath, AddArcToPath, DrawPath, DrawPathEvenOdd