THPDFHeadlessDocument.SetTextFieldValueWithAppearance

procedure SetTextFieldValueWithAppearance(FieldIndex: Integer;
  const Text: UnicodeString; const TrueTypeFont: SysUtils.TBytes;
  const Options: THPDFHeadlessTextAppearanceOptions);

書き込み可能な末端 AcroForm テキストフィールドを更新し、既存の各ウィジェットに明示的な通常外観を構築します。ネイティブ Linux と Windows の双方で、同じドキュメントオブジェクトグラフを使います

外観の寸法はウィジェットの矩形から得られます。継承されたフィールドの Q があれば左寄せ・中央・右寄せの配置に使われ、なければオプション側の配置が適用されます

このプロファイルは、単一行と複数行のプレーンテキスト、文字フォールバック付きの実測ワードラップ、CR/LF 改行、固定サイズとオートフィット、正の継承 MaxLen を持つ comb セル、90 度倍数のウィジェット回転に対応しています

ShapeComplexText が有効な場合、複雑なスクリプト、bidi ラン、リガチャ、結合シーケンスは HarfBuzz と FriBidi を使います。直接 Unicode テキストはこれらのランタイムに依存せず、欠落グリフや不正なサロゲートペアは外観の診断を発生させます

複数行の複雑な折り返しは、bidi の並べ替えと再形成の前に、論理的な Unicode クラスタに対して行われます。comb セルはスカラーにつき 1 グリフという直接プロファイルを保ちます

既存のリッチテキストフィールドに対しては、このメソッドは内容を単一のプレーンスタイルで置き換え、V、RV、すべてのウィジェット外観を同期します。混在スタイルを渡したい場合は SetRichTextFieldValueWithAppearance を使ってください

パスワードフィールドは Unicode スカラーにつき 1 つのビュレットを生成し、実際の Unicode フィールド値は V に保持します。外観のグリフマッピングとアクセシビリティテキストにはマスクが入り、値自体はドキュメントの暗号化ポリシーに従います

パスワードフィールドを複数行や comb フィールドにすることはできません。不正な Unicode、制御文字、マスクグリフの欠落、キャンセル、リソース枯渇が起きても、元のフィールドは保持されます

ファイル選択フィールドは、Unicode のパスをそのまま通常のフィールドテキストとして表示します。この操作は選択されたファイルを開かず、実行も添付もしません

フォントは、有効な名前付き TrueType アウトラインと実メトリック、installable か editable の埋め込みフラグを要求します。フォント全体の埋め込みでは no-subsetting 権限を尊重し、restricted、preview-and-print、bitmap-only、欠落、不明の各権限は拒否します

このメソッドはフィールドを変更する前に、フィールド置換、外観ディクショナリー、新しいフォントと Form オブジェクト、シリアライズ予算をすべて準備します。プリフライトに失敗したときは、以前の値と外観リンクが保持されます

新しいオブジェクトはドキュメントが所有し、元の有界なインクリメンタルライターを通じて保存されます。新しい文字列とストリームの暗号化も、元の AES-256 R5 / R6 ポリシーに従います

明示的な外観が変更されたフィールドをカバーした後、NeedAppearances はクリアされます。ただし別の値のみの編集や、元から残る未解決の外観要求があればクリアされません

元のフラグが true だった場合、他の非署名フィールドは外観要求が満たされるまで保守的に true を保ちます。これらのフィールドの再生成には、別途用意された choice 用と button 用メソッドを使ってください

読み取り専用、MaxLen、既存の署名、証明権限、AES のフォーム入力権限、ソース保護、キャンセル、アトミック出力ポリシーは引き続き有効です

ドキュメントと外観オプションの両方でキャンセルトークンを指定する場合、両者は同じトークンでなければなりません

有界なフォントとレイアウトの契約については、THPDFHeadlessTextAppearanceOptions と HPDFBuildHeadlessTextAppearance を参照してください