HPDFXFAResolveBoundDataNode
ユニット: HPDFXFA
宣言
function HPDFXFAResolveBoundDataNode(ADocument: TXFADocument;
AFieldNode, ADataNode: TXFANode; ACreate: Boolean;
out ABindingHandled: Boolean): TXFANode; overload;
function HPDFXFAResolveBoundDataNode(ADocument: TXFADocument;
AFieldNode, ADataNode: TXFANode; ACreate: Boolean;
out ABindingHandled: Boolean; var RemainingOperations: Integer;
Deadline: Int64; DeadlineCheck: TXFABindingDeadlineCheck = nil): TXFANode; overload;
パラメーター
| パラメーター | 意味 |
|---|---|
| ADocument | データセットパケットとテンプレートパケットを所有するネイティブドキュメント |
| AFieldNode | bind 宣言または暗黙名を含むテンプレートフィールド |
| ADataNode | 暗黙バインディングと互換相対バインディングにおける、現在のネイティブデータ出現 |
| ACreate | 決定論的な欠落パスが、有効な XML 名を持つ所有済みネイティブ要素を生成できるようにします |
| ABindingHandled | リゾルバーが処理した明示的な none または dataRef バインディングを報告します。処理済みのバインディングでも nil を返すことはあります |
| RemainingOperations | 共有の操作許容量で、解析、名前空間チェック、走査のたびに減算されます。0 は枯渇、負の値はこの呼び出し側の許容量を無効化します |
| Deadline | 供給されたコールバックのクロックドメインにおける絶対デッドライン。負の値で経過時間チェックを無効化します |
| DeadlineCheck | 省略可能な同期オブジェクトメソッド。nil の場合は GetTickCount64 のミリ秒が使われます |
動作
返されたノードは ADocument に属し、呼び出し側が解放してはなりません。暗黙のフィールド名は、ドットを含むリテラルな XML 名です
dataRef の検索は、$data と $record のルート、子孫演算子、ワイルドカードとクラスのセレクター、明示的な兄弟インデックス、[*]、エスケープされたセレクター文字に対応しています。例と境界については ネイティブ XFA Bind SOM を参照してください
供給された繰り返し出現で暗黙値が見つからない場合、その出現に局所的なままとなり、別の出現へフォールバックしません
ADataNode が供給されているとき、互換相対 dataRef パスも同様に局所的なままです。相対参照の record と root へのフォールバックは、呼び出し側に出現コンテキストがないときにだけ適用されます
読み取り専用の検索はデータノードを確保しません。生成は決定論的な名前付きパスに適用され、曖昧なワイルドカード・クラス・子孫の検索は検索操作のままです
未解決のサフィックスや例外が起きると、このリゾルバー呼び出しが確保した中間ノードは削除されます。既存のノードは所有されたまま、変更されません
走査は、省略可能な呼び出し側上限に加え、パス走査ごとにセレクターセグメント 64 個、要素レベル 64 段、課金ステップ 200000 回という固定上限を使います
操作または経過時間の予算を使い切ると EHPDFXFAError が発生します。インタラクティブな編集とイベントは、自分を包むネイティブトランザクションスナップショットを復元します