THotPDF.SetLoadedFreeTextText メソッド

ロード済み FreeText 注釈の通常外観を、埋め込み Unicode フォント、任意のリッチテキスト、アトミックなグラフトランザクションで置き換えます

宣言

procedure SetLoadedFreeTextText(PageIndex, AnnotationIndex: Integer;
  const AText: UnicodeString; const Options: THPDFLoadedTextAppearanceOptions;
  const RichContent: AnsiString = ''; const DefaultStyle: AnsiString = '');

オプション

個々のフィールドを変更する前に、THPDFLoadedTextAppearanceOptions.Default でレコードを初期化します

フィールド	挙動
FontName, FontStyle, FontSize	プライマリフォント、スタイル、ポイントサイズです。デフォルトは Arial、regular、12 ポイント
TextColor, Alignment, Padding	プレーンテキストの色、left/center/right の整列、ポイント単位のパディングです。デフォルトは黒、left、2 ポイント
Opacity, Rotation	不透明度は [0,1]、回転は 90 度の倍数です
OverflowPolicy	`THPDFLoadedTextOverflowPolicy`: `ltopReject` ははみ出しを拒否し、`ltopClip` はクリップし、`ltopShrinkToFit` は小さめのフォントで再試行します
MinFontSize	縮小時の下限です。デフォルトは 4 ポイント
MaxTextUnits	入力とプレーンテキストの予算です。デフォルトは 1,048,576 UTF-16 単位で、リッチ入力はこの予算の 4 倍までに制限されます

使用上の注意

AText はプレーンな Unicode テキストを供給します。空でない UTF-8 の RichContent がある場合は、代わりに HTML インポーターと任意の CSS DefaultStyle が使われ、生成テキストから /Contents が導出されます

生成された外観は、埋め込みフォントと ToUnicode マッピングをロード済みドキュメントへコピーするので、保存、フラット化、テキスト抽出でも Unicode テキストが保たれます

このメソッドは、設定済みのフォントフォールバックチェーン、ShapingFeatures、アラビア語・シリア語・ンコ語・アドラム語・ハニフィ・ロヒンギャ語の自動 shaping スイッチ、GSUB のスクリプトと言語選択を継承します。shrink-to-fit の各再試行は同じ設定を使い、呼び出し側の設定を変更しません

対応している背景、実線/破線の境界、矩形インセット、2/3 ポイントのコールアウトジオメトリは保存され、/AP、/Contents、/RC、/DS、/CA、/Q、回転メタデータが同期されます

無効なジオメトリ、未解決のプレーンテキストグリフ、cloudy 境界、リソース上限、拒否されたはみ出しは例外を送出し、更新全体をロールバックします。すでに外側にあるグラフトランザクションはアクティブのままです

リッチテキストは対応する HTML/CSS サブセットに従います。外部リソースは無効で、固定の CSS フォントサイズは shrink-to-fit が個々の run を縮小できない原因になることがあります

各外観ライターは、最大 256 個の異なる shaping フォント選択と、累積 64 MiB の生フォントデータを受け入れます。どちらかを超えると更新は拒否され、元の注釈が保たれます

THotPDF.SetLoadedFreeTextText メソッド

宣言

オプション

使用上の注意

関連 API