順序付きリッチテキストフォント候補リスト

リッチテキストは明示的な順序付きファミリーリストを保持でき、完全な Unicode 書記素に対して実際に供給されたフォントプログラムを選ぶときに、その順序を使えます

Run:= THPDFHeadlessRichTextRun.Default;
Run.Text:= 'A' + WideChar($03A9) + 'B';
Run.FontFamily:= 'Primary';
SetLength(Run.FontFamilyCandidates, 3);
Run.FontFamilyCandidates[0]:= 'Primary';
Run.FontFamilyCandidates[1]:= 'Serif';
Run.FontFamilyCandidates[2]:= 'Sans';
Options:= THPDFHeadlessTextAppearanceOptions.Default;
Options.FallbackFontFamilies:= True;

実際のファミリープログラムとスタイルプログラムは、既存の名前付きファミリー API で供給してください。FontFamilyCandidates 内のラベルがフォントを検出したりダウンロードしたりすることはありません

選択と保持

スタイルの継ぎ目や結合記号を含む書記素全体についてのリストは、影響を受けた最初の記述済み run が供給します。設定された各候補は、スタイル付きのすべての部分を、その実際の regular・bold・italic・bold-italic プログラムでカバーしなければなりません

不明なラベルと、スタイルプログラムが欠けている候補はスキップされます。宣言された候補のどれも書記素をカバーしない場合は、既存の選択済みファミリーと供給配列のフォールバック規則が適用されます

空でない候補リストが存在する場合、FontFamily はその中の最初の設定済みラベルと一致していなければなりません。型付き JSON で FontFamily を省略すると、この一致が自動的に選択されます

フォールバックが変えるのは外観の準備だけです。記述されたプレーン値、正確な型付きサイズと色、元の候補順序は V と RV に残り、リゾルバーが呼び出し側の run を書き換えることはありません

インライン XHTML とインターチェンジ

サポート対象のカンマ区切りインライン font-family 宣言（継承とプロパティごとの important 優先度を含む）を保持するには、FontFamilyNames を設定した上で THPDFHeadlessRichTextDecodeOptions.PreserveFontFamilyLists を True にします

ファミリー対応の FDF / XFDF インポートは、外観オプションで FallbackFontFamilies が有効になっているときにこの保持を有効化します。厳格なデフォルトデコードは、既存の最初の設定済みファミリー選択を維持します

リストは最大 16 個のラベルを含み、各ラベルは有効な Unicode で 128 UTF-16 コードユニットまでに制限され、制御文字、前後の空白、引用符、バックスラッシュ、カンマ、セミコロンは使えません。重複したラベルや不明な宣言ラベルも、記述された順序を保持します

ネイティブ Linux JSON

{"schemaVersion":1,"type":"forms.fill",
 "fontFamilies":["Primary","Sans","Serif"],"fallbackFontFamilies":true,
 "fields":[{"name":"Input","richTextRuns":[
   {"text":"A\u03a9B","fontFamily":"Primary",
    "fontFamilyCandidates":["Primary","Serif","Sans"]}
 ]}]}

宣言された Serif → Sans の順序は、操作側が Sans を Serif より先に設定していてもフォールバックを制御します。実際の名前付きプログラムの供給は既存の Fontconfig プロバイダーが、同じフォント合計とメモリ上限の中で行います

型付き run の候補配列には、設定済みの fontFamilies と有効化された fallbackFontFamilies が必要です。不正な配列やラベル、書記素全体のカバレッジ欠落、予算の枯渇、キャンセルは、コンテキストのコミット前にトランザクション的に失敗します

formData.richFontFamilyCandidates ケイパビリティと maxFontFamilyCandidates=16 が、この有界なオプションを、変更のない V1 コールバックとエクスポートシンボルバージョンを通じて通知します

成功した連鎖フォームフィルと同等の FDF / XFDF インポートは、コミット済みのドキュメントとソーススナップショットを保持します。出力や結果コールバックが失敗した場合は、直前のコミット済みリビジョンが保たれます

適用範囲

このプロファイルがカバーするのは、供給された候補ラベルとサポート対象のインライン宣言です。外部スタイルシート、任意の CSS レイアウト、ジェネリックファミリーの検出、Windows コールバックでのフォールバック読み込みは、引き続き別の作業です

フォールバック動作 · 型付き run レコード · デコードオプション · ネイティブ Linux バインディング