AddPolygonAnnotation

注釈とホットスポットリンク

説明

指定された頂点リストを使用して、閉じた多角形マークアップ注釈（PDF /Subtype /Polygon）を選択したページに追加します。多角形は暗黙に閉じられます — レンダリング時にリーダーが最後の頂点を最初の頂点へ接続します。図形の内部はオプションで単色塗りつぶしにできます。色コンポーネントと不透明度は 0–1 の範囲、Transparency は 0–100 の範囲（0 = 完全に不透明、100 = 完全に透明）で表します。低い最小バージョンのロック中に Polygon 注釈を出力すると、ライブラリは文書バージョンを PDF 1.5 に引き上げます。ISO 32000-1 §12.5.6.9 で定義されています

構文

Delphi

Function TPDFlib.AddPolygonAnnotation(Const VertexCoords: WideString; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

パラメータ

VertexCoords — x/y 値を交互に並べ、スペース、カンマ、セミコロン、またはタブで区切った単一文字列の頂点座標。例: "100 100 200 100 200 200 100 200" は正方形を定義します。少なくとも 2 組（4 個の数値）が必要で、数値の総数は偶数でなければなりません。それ以外の場合、呼び出しは 0 を返します

BorderWidth — 現在の単位で表す多角形輪郭のストローク幅

BorderRed、BorderGreen、BorderBlue — /C に書き込まれる輪郭色の RGB 成分（0–1）

Filled — ポリゴン本体に内部塗りつぶし色 (/IC) を出力する場合は 1、塗りつぶさない場合は 0

FillRed、FillGreen、FillBlue — 内部塗りつぶし色の RGB 成分（0–1）。Filled が 0 の場合は無視されます

Title — 注釈's /T エントリに書き込む作成者名です。省略するには空文字列を渡します

Contents — 注釈に関連付けられたポップアップの本文。スキップするには空文字列を渡します

透明度 — パーセントで表す透過率（0–100）。ライブラリはこれを PDF /CA = 1 - Transparency/100 に変換し、範囲にクランプする

戻り値

成功時は 1、ドキュメントが選択されていない場合、頂点文字列の解析に失敗した場合、または注釈を作成できなかった場合は 0

備考

注釈の /Rect は、頂点範囲に境界線幅に比例する小さな余白を加えて自動計算されるため、輪郭ストロークが注釈の境界ボックス内に収まります

PDF 仕様で説明されている任意の高度なフィールド — /BE（曇りアウトラインスタイルを含む境界線効果）、/IT（PolygonCloud および PolygonDimension を含む意図）、および /Measure — は、このエントリポイントでは出力されません。作成後にアノテーション辞書へ直接書き込むことで追加できます

作成後にアウトラインの色、境界線、内容、または矩形を上書きするには、SetAnnotBorderColor、SetAnnotBorderStyle、SetAnnotContents、SetAnnotRect を使用します