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