THotPDF.ImportLoadedFormFromXFDF Method

يستورد قيم حقول النموذج من ملف XML Forms Data Format (XFDF) إلى المستند المحمّل

الاستيراد ذري عبر جميع الحقول: فالتحديث اللاحق المرفوض يرجِع القيم الأسبق والمظاهر المولَّدة إلى ما كانت عليه، بينما يحافظ الاستيراد الناجح على أي معاملة رسم بياني محيطة يملكها المستدعي

تملأ عناصر القيم المتعددة حقل اختيار متعدد الانتقاء دون ضم النص أو تقسيمه عند فواصل الأسطر؛ وتعيد الانتقائيات المدعومة بناء قيمة الحقل ولوازم الانتقاء دون تعديل الافتراضات في الأسلاف أو الحقول الشقيقة

يترك عنصر الحقل بلا قيمة الحقل القائم دون تغيير؛ وقيمة فارغة واحدة تمسح انتقاء حقل متعدد بلا خيار تصدير فارغ، أو تختار ذلك الخيار عند وجوده

تتحقق صحة قيم المصفوفات قبل تغيير حقلها الهدف؛ واطلب صراحة إعادة توليد المظهر قبل الحفظ عندما يجب أن تتغير نصوص ظاهرة أو مظاهر اختيار

تتخذ قيم الخيارات الدقيقة الأولوية عبر قائمة الانتقاء المستوردة كاملة، بغض النظر عن ترتيب الخيارات؛ ولا يستخدم الاحتياط التوافقي لتهجئات النظام السداسي إلا نص XFDF غير المطابق، ويخزّن الاحتياط الناجح قيمة الخيار المطابقة فعليًا

تقبل نسخة HPDFXFDFImportFields منخفضة المستوى سجل THPDFXFDFArrayAccess منفصلًا مهيأ؛ ويعيد مُضبطها القيمة true بعد معالجة قائمة القيم الكاملة، وإلا فتتحول قيمة مفردة إلى المُضبط القياسي وتُرفض القيم المتعددة

تحتفظ النسخة منخفضة المستوى الأصلية بسلوكها القديم للتكاملات القائمة، بما في ذلك ضم القيم المتعددة بـ LF؛ وتستخدم THotPDF النسخة المدركة للمصفوفات الجديدة

الصيغة

function ImportLoadedFormFromXFDF(const AFileName: TFileName): Integer;

المعاملات

AFileName: TFileName

اسم ملف بيانات XFDF المطلوب استيرادها

القيمة المُعادة

تعيد عدد الحقول المحدَّثة؛ ويعيد الملف المفقود صفرًا، بينما قد ترفع عمليات إدخال/إخراج الملف وتحديثات الحقول المرفوضة استثناءات