AddCircleAnnotation

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

説明

指定した長方形に内接する楕円マークアップ注釈（PDF /Subtype /Circle）を追加します。名前にかかわらず、この注釈は完全な楕円であり、Width と Height が等しい場合だけ真円としてレンダリングされます。必要に応じて単色の内部色で塗りつぶせます。色成分と不透明度は 0–1 の範囲で表し、Transparency は 0–100 の範囲で指定します（0 = 完全に不透明、100 = 完全に透明）。このエントリポイントは PDF 1.4 注釈の /CA 不透明度キーを出力するため、ライブラリは保存前にロックされていない下位文書を PDF 1.4 へ引き上げます。ロックされた下位ターゲットは互換性ゲートで拒否されます。ISO 32000-1 §12.5.6.8 で定義されています

構文

Delphi

Function TPDFlib.AddCircleAnnotation(Left, Top, Width, Height: Double; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

パラメータ

左 — 現在の単位で表した境界矩形's 左下隅の水平座標

Top — 現在の単位での境界長方形'の左下隅の垂直座標

Width — 境界長方形の幅

Height — 境界矩形の高さ

BorderWidth — 現在の単位で表した楕円境界線のストローク幅。従来の /Border フィールドと /BS 境界線スタイル辞書の両方に書き込まれます

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

Filled — 1 の場合は内部の塗りつぶし色（/IC）を出力し、0 の場合は楕円を塗りつぶしません

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

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

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

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

戻り値

成功時は 1、ドキュメントが選択されていないか注釈を作成できない場合は 0

備考

注釈は標準のマークアップフィールドセットで出力されます: /Type /Annot、/Subtype /Circle、/Rect、/C、/IC（Filled の場合）、/BS、/Border、/CA、/F = 4（印刷可能）、/M、/CreationDate、/NM、/T、/Contents、/Subj = "Ellipse"、/P。これは Adobe Acrobat と Foxit の楕円レビューツールが生成する内容と一致するため、外部レビューのワークフローから生成された注釈を検索、編集、コメント、および返信できます

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