AddPolyLineAnnotation

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

説明

指定した頂点一覧を使用し、選択したページに開いたポリラインマークアップ注釈（PDF /Subtype /PolyLine）を追加します。ポリラインは開いており — 読み上げ機能は最後の頂点を最初の頂点へ接続しません — 各終端に異なる端線スタイルを指定できます。内部を持つ端部装飾（ClosedArrow、Square、Circle、Diamond）は必要に応じて塗りつぶせます。色成分と不透明度は 0–1 の範囲で表し、Transparency は 0–100 の範囲で指定します（0 = 完全に不透明、100 = 完全に透明）。低い最小バージョンロックの下で PolyLine 注釈を出力すると、ライブラリは文書バージョンを PDF 1.5 へ引き上げます。ISO 32000-1 §12.5.6.9 で定義されています

構文

Delphi

Function TPDFlib.AddPolyLineAnnotation(Const VertexCoords: WideString; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

パラメータ

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

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 は頂点の範囲に境界線幅に比例した余白を加えて自動計算されるため、端の装飾は注釈の境界ボックス内に収まります

PDF 仕様で説明される任意の高度なフィールド — /IT（PolyLineDimension を含む intent）および /Measure — は、このエントリポイントでは出力されません。作成後、注釈辞書へ直接書き込むことで追加できます

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