AddLineAnnotation

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

説明

選択したページの 2 つの端点間に線マークアップ注釈（PDF /Subtype /Line）を追加します。各端点には異なる端線スタイル（arrow、square、circle、diamond、…）を指定でき、線本体は設定可能な不透明度を持つ任意の RGB 色で描画できます。内部を持つ端部装飾（ClosedArrow、Square、Circle、Diamond）は必要に応じて塗りつぶせます。このエントリポイントは PDF 1.4 注釈の /CA 不透明度キーを出力するため、ライブラリは保存前にロックされていない下位文書を PDF 1.4 に引き上げます。ロックされた下位ターゲットは互換性ゲートで拒否されます。ISO 32000-1 §12.5.6.7 で定義されています

構文

Delphi

Function TPDFlib.AddLineAnnotation(StartLeft, StartTop, EndLeft, EndTop: Double; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

パラメータ

StartLeft、StartTop — 現在の単位で表した線の開始端点（line's）の座標

EndLeft、EndTop — 現在の単位での線's 終端座標

BorderWidth — 現在の単位で表す線およびその端部装飾のストローク幅

LineRed、LineGreen、LineBlue — /C に書き込む線色の RGB 成分 (0–1)

StartStyle、EndStyle — それぞれ開始端点と終了端点の終端線スタイル。次のいずれかを使用します:

0 = None、1 = Square、2 = Circle、3 = Diamond、4 = OpenArrow、5 = ClosedArrow、6 = Butt、7 = ROpenArrow、8 = RClosedArrow、9 = Slash

範囲外の値は 0（None）にクランプされます

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 は、終端装飾が注釈境界ボックス内に収まるよう、2 つの終点と境界線幅に比例するパディングから自動計算されます。PDF リーダーでは境界の /Rect が表示描画全体を含む必要があり、そうでない場合は終端装飾がクリップされる可能性があります

PDF 仕様で説明されている任意の高度なフィールド — /LL（引出線長）、/LLE、/LLO、/Cap、/CP、/CO、および /Measure — は、このエントリポイントでは出力されません。作成後にアノテーション辞書へ直接書き込むことで追加できます

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