AddCaretAnnotation

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

説明

選択したページにキャレットマークアップ注釈（PDF /Subtype /Caret）を追加します。キャレット注釈は、テキストまたはコンテンツが挿入、削除された、またはレビュー担当者の注意を要するページ上の位置を慣例的に示す視覚記号です。記号形状は、通常のキャレット（None）または段落記号（Paragraph）の 2 種類から選べます。色成分と不透明度は 0–1 のスケールで表し、Transparency は 0–100 のスケールで指定します（0 = 完全に不透明、100 = 完全に透明）。より低い最小バージョンロック下で Caret 注釈を出力すると、ライブラリは文書バージョンを PDF 1.5 に引き上げます。ISO 32000-1 §12.5.6.11 で定義されています

構文

Delphi

Function TPDFlib.AddCaretAnnotation(Left, Top, Width, Height: Double; SymbolType: Integer; ColorRed, ColorGreen, ColorBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

パラメータ

Left — 現在の単位での注釈長方形'の左下隅の水平座標

Top — 現在の単位で表す注釈矩形's 左下隅の垂直座標

Width — 注釈矩形の幅

高さ — 注釈矩形の高さ

SymbolType — Caret シンボルのスタイル:

0 = なし（通常のキャレット "^"）

1 = 段落（段落記号 "¶"）

その他の値はすべて 0（なし）として扱われます

ColorRed、ColorGreen、ColorBlue — /C に書き込まれるキャレット色の RGB 成分（0–1）

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

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

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

戻り値

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

備考

この注釈は /Type /Annot、/Subtype /Caret、/Rect、/Sy（シンボル名）、/C、/CA、/F = 4（印刷可能）、/M、/CreationDate、/NM、/T、/Contents、/Subj = "Caret"、/P を伴って出力されます。任意の /RD フィールド（/Rect 内のキャレットオフセット）は出力されず、リーダーは既定で全値をゼロとするため、キャレットは注釈矩形全体を占めます

作成後に注釈の矩形、色、または内容を上書きするには、SetAnnotRect、SetAnnotBorderColor、SetAnnotContents を使用します