HPDFXFAResolveFieldValueNode

الوحدة: HPDFXFA

الإعلان

function HPDFXFAResolveFieldValueNode(Document: TXFADocument;
  FieldNode, DataNode: TXFANode; CreateNode: Boolean= False;
  MaxNodes: Integer= 65536): TXFANode; overload;

function HPDFXFAResolveFieldValueNode(Document: TXFADocument;
  FieldNode, DataNode: TXFANode; CreateNode: Boolean;
  MaxNodes: Integer; var RemainingOperations: Integer; Deadline: Int64;
  DeadlineCheck: TXFABindingDeadlineCheck = nil): TXFANode; overload;

المعاملات

المعاملالمعنى
Documentالمستند الأصلي لـ XFA المالك لـ packets الحقل والبيانات والنموذج
FieldNodeحقل القالب الذي تُطلب قيمته الفعالة
DataNodeسياق نسخة dataset؛ والحقول المتكررة تتطلب سياق نسختها الخاص
CreateNodeFalse تحل بيانات قابلة للقراءة أو قيمة نموذج أو افتراضي القالب؛ وTrue تعيد قيمة نسخة قابلة للكتابة
MaxNodesحد النسخة الممرَّر إلى إنشاء نسخ النموذج الأصلية

السلوك

عقدة dataset مرتبطة قائمة تسبق حتى عندما يكون محتواها فارغًا؛ والعقدة المفقودة ترجع إلى قيمة النموذج الأصلية المقابلة ثم إلى أول ابن قيمة في حقل القالب

البحث للقراءة فقط لا ينشئ عقدة dataset أو نموذج، ويعيد nil عندما لا يوجد أي من مصادر القيمة هذه

مع CreateNode بقيمة True، ينشئ الربط العادي للبيانات عقدة dataset القابلة للكتابة أو يعيدها؛ والحقل غير المرتبط أو المستند دون datasets قابلة للكتابة يستخدم قيمة نموذج أصلية منفصلة بدلًا

عقدة dataset حديثة الإنشاء يمكن أن تكون فارغة مبدئيًا؛ وعلى المستدعي تزويد القيمة المُرسَلة بدلًا من الإسناد عبر افتراضي قالب معاد سابقًا

العقدة المعادة تنتمي إلى Document ويحظر على المستدعي تحريرها؛ ويمكن للبحث للقراءة فقط أن يعيد عقدة قالب مشتركة، فاحصل على عقدة قابلة للكتابة بـ CreateNode=True قبل تغيير محتواها

Document أو FieldNode بقيمة null تعيد nil؛ وفهارس نسخ النموذج الأصلية الزائدة أو عمق الأسلاف تثير EHPDFXFAError عبر محلل النموذج

المستهلكون

التحميل ذو الميزانية يتشارك إذن العمليات والموعد النهائي للمستدعي مع حل الربط الأصلي؛ وRemainingOperations بصفر مستنفدة والسالب تعطّل إذن المستدعي وDeadline السالبة تعطّل فحوص الوقت المنقضي

DeadlineCheck يمكنها تزويد نطاق ساعة المستدعي؛ وnil تستخدم مللي ثانية GetTickCount64، بينما تزوّد بيئة التشغيل التفاعلية فحص موعدها الأحادي المهيأ

مسوحات الربط تحفظ حدود المقاطع وعمق التجوال والخطوات المحتسبة الثابتة؛ وفشل الميزانية يثير EHPDFXFAError والمعاملات التفاعلية تستعيد snapshot الأصلي لديها

انظر HPDFXFAResolveBoundDataNode وTXFABindingDeadlineCheck لعقد ميزانية الربط وcallback

بيئة التشغيل التفاعلية وتحويل XFA إلى AcroForm تتشاركان هذا المحلل، محفظتين اتساق الافتراضيات المفقودة والبيانات الفارغة الصريحة وقيم النسخ المتكررة

التعديلات التفاعلية والحسابات تعيد اقتناء عقدة نسخة قابلة للكتابة قبل الإرسال، محفظةً افتراضي القالب لبقية النسخ

واجهات مرتبطة

افتراضيات الحقول الأصلية في XFA, HPDFXFAResolveFormInstanceNode وبيئة تشغيل widgets XFA الديناميكية التفاعلية