自動 XFA プッシュボタンのキャプションと状態
HPDFXFAWriteHeadlessPDF は XFA レイアウトから実際のネイティブプッシュボタンウィジェットを生成します。実効的なスカラー・XHTML キャプション、指定フォントプログラム、可視性、readonly フラグ、インタラクティブハイライトメタデータも含みます
各ウィジェットは FT Btn、プッシュボタンの Ff フラグ、明示的な normal アピアランス、実際の描画内容から導かれた Unicode の MK.CA キャプションを持ちます。ボタンがテキスト入力フィールドになることはなく、プレースホルダーの PDF フィールドも不要です
可視の normal キャプションは DA エントリも保持し、そのフォントエイリアスは AcroForm.DR を通じて実際の normal キャプション Type0 フォントに解決されます。互換性のための空プレースホルダーフォントは埋め込まれません
キャプションコンテンツとレイアウト
スカラーキャプションのフォントサイズ、ウェイト、ポスチャー、タイプフェイス、色に加え、XHTML インラインスタイルと混在ベースラインは、既存のネイティブリッチテキストデコーダーとアピアランスビルダーを使います
CaptionFontFamilies は実際の regular、bold、italic、bold-italic プログラムと名前付きファミリーを供給します。フェイスが合成されることはなく、フォントプログラムの探索やダウンロードも行いません
XHTML インライン要素間の空白だけのテキストは保持されるため、隣接する異なるスタイルの単語は記述された区切りを保ちます
キャプションコンテンツが欠ける場合は既存のフィールド名フォールバックが使われます。明示的に空のコンテンツは空白のままとなり、空でないスカラーキャプションは記述された前後の空白を保持します。hidden、inactive、invisible のキャプションはテキストを描かず、再生成可能な可視キャプションもシリアライズしません
フィールドとキャプションのマージン、キャプション配置、reserve、段落配置が実際のキャプション領域を決めます。欠落、0、スキーマ既定の -1 の reserve は自動折り返しなしで自然な範囲を使い、正の reserve は折り返しを許し、インライン配置は reserve を無視します
固定のフィールド境界は大きすぎるキャプションをクリップします。明示的な段落区切りは有効なままで、実効的なインスタンスごとのオーバーレイは変更されていないテンプレート兄弟を保持します
ハイライトと状態のアピアランス
| XFA ハイライト | ネイティブ PDF の結果 |
|---|---|
| inverted or absent | normal AP.N とともに H I。リーダーが反転アクティベーション処理を適用します |
| none | normal AP.N とともに H N |
| outline | normal AP.N とともに H O。リーダーが枠線アクティベーション処理を適用します |
| push | 実際の normal AP.N、down AP.D、rollover AP.R Form とともに H P。押下を表すために down キャプションは移動されます |
push モードでは、down と rollover という名前のスカラー項目がそれぞれのキャプションと MK.AC・MK.RC メタデータを供給します。状態項目が欠ける場合は normal キャプションが使われ、明示的に空の項目は空白の状態になります
代替項目は他のハイライトモードに影響せず、生成された各状態は固有の実際のアピアランスと供給フォントグラフを保持します
トランザクションと上限
実際の繰り返しインスタンスのイベント変更は XDP として保存・再ロードでき、クリエーターが消費できます。即時読み取り、オーバーレイとペイロード全体の置き換え、最初のインスタンスの分離、失敗イベントのロールバックはネイティブランタイムの操作のままです
ソースノードとバイト、フォントプログラム、グリフユニット、オブジェクト、候補バイトには上限があります。キャンセルと準備失敗は呼び出し側ストリームのバイト、長さ、位置を保ちます
呼び出し側ストリームへの最終書き込みがコミット境界です。書き込み中にそのストリームが送出した例外は部分的な書き込みを残すことがあり、ロールバック済みの非シーク出力先として提示されることはありません
このコンシューマは保存済みウィジェットアピアランス状態を作成します。後のリーダー主導 XFA スクリプト実行やアピアランス再構築、リッチな代替項目コンテンツ、ボタンアイコン、外部メディア、任意の外部 XML 描画は別機能のままです
ハイライトとキャプション reserve のマッピングはXFA 3.3 の button とcaption のセマンティクスに従います