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