ネイティブ XFA UI プロパティ上書き
ユニット: HPDFXFA、HPDFXFARuntime、HPDFXFAEventScript
作成と選択グループ
サポート対象のフィールドと draw の UI ノードは extras と picture を公開し、さらに排他的なウィジェット選択を 1 つ持ちます。barcode、button、checkButton、choiceList、dateTimeEdit、defaultUi、imageEdit、numericEdit、passwordEdit、signature、textEdit です
各子のカーディナリティは 1 です。getElement と直接プロパティアクセスは、実際のフォーム出現の下にサポート対象の存在しないプロパティを実体化し、ネイティブ作成予算とトランザクションロールバックを共有します
const row = xfa.form.resolveNode("main.row[1]");
row.input.ui.textEdit.multiLine = "1";
row.input.ui.textEdit.hScrollPolicy = "off";
row.password.ui.passwordEdit.hScrollPolicy = "off";
row.selection.ui.choiceList.open = "multiSelect";
row.selection.ui.choiceList.commitOn = "select";競合するウィジェット選択の作成はイベントトランザクションを失敗させます。extras と picture はメタデータのままで、実効 UI ウィジェットの選択時にはスキップされます
既定値とサポートされる子パス
UI、passwordEdit、choiceList、checkButton は共通の id、use、usehref スキーマ属性を公開します
passwordEdit の既定は hScrollPolicy=auto と passwordChar=* です。choiceList の既定は open=userControl、textEntry=0、commitOn=select です
passwordEdit、choiceList、checkButton は border、extras、margin の子に対応します。textEdit は既存の border、comb、extras、margin のパスと文脈依存の既定値を保ちます
checkButton の既定は size=10pt、shape=square、mark=default、allowNeutral=0 です。自動ネイティブブール作成は、実効的なインスタンスごとのマーカー、ボーダー、スカラーキャプションの各プロパティを消費します
setAttribute(value, name) は明示的な追加属性に引き続き使えます。さらなるウィジェットクラスの既定値と子スキーマは、別途の対象として続きます
実際のランタイムと flatten コンシューマ
ランタイムは成功したイベントの後に、繰り返し出現ごとに実効 UI からウィジェット種別を再構築します。作成された textEdit、passwordEdit、choiceList ノードは実際のテキスト、パスワード、リスト・コンボコントロールになります
フィールドの flatten は同じ実効 UI 選択を使います。ネイティブのフォーム専用 UI や、空またはメタデータのみのテンプレート UI に追加されたウィジェット選択も含みます
UI 属性は実際の PDF フィールドフラグに反映されます。複数行・スクロールなしテキスト、パスワードマスク、複数選択、選択時コミットです。宣言された項目オプションと現在のバインド値は接続されたままです
他の繰り返しインスタンスは以前の UI と値を保持します。保存済み XDP の再ロードと後続のイベントも、作成されたネイティブ UI プロパティノードを解決し続けます
保存テキストアピアランス
AutoFormAppearances が有効なとき、XFA の複数行テキストアピアランスは明示的な LF、CR、CRLF の改行を尊重し、各行を個別に配置します
サポート対象のシングルバイトテキストでは、折り返しが実効的な標準フォントファミリーとサイズを計測します。コントロールより広い単語は計測済みの収まる接頭辞へ分割され、生成アピアランスにすべてのテキスト文字が保持されます
出力された各行は実効的な left、center、right の配置と既存のネイティブクリップ矩形を消費します
対応範囲
スキーマ作成だけでは、すべてのウィジェット選択に欠けているコンシューマは追加されません。特殊な image、barcode、既定ウィジェットの動作、カスタムパスワード文字、より豊富なウィジェットテキスト、Unicode 埋め込み、追加の value 子作成は、現在も進行中の対象です
欠けている暗黙 datasets 値のテンプレート既定初期化と、汎用的なプロトタイプ継承も、別途の作業です
リファレンスと関連 API
UI 文法と既定値はXFA 3.3 仕様に従います