نقل مضيف XFA الصريح

الوحدة: HPDFXFARuntime

التصريح

Options := TXFAWidgetRuntimeOptions.Default;
Options.ScriptOptions.EnableJavaScript := True;
Options.HostTransport := ApplicationHost.Transport;
Options.OnHostTransactionCompleted := ApplicationHost.Completed;

السلوك

هيّئ callbacks تطبيقًا صريحةً لتنفيذ xfa.host.messageBox وresponse وbeep وprint وgotoURL وsubmitForm وimportData وexportData وFormCalc Get وPost وPut

المكتبة لا تستدعي dialog أو قارئًا أو طلب شبكة أو نقل ملفات تلقائيًا؛ وcallback تنفذ نقل التطبيق وتُعيد استجابة موسومة

كل طلب مرسل يجري مرة واحدة داخل معاملة بيئة تشغيل محيطة؛ وإعادة محاولات تعليق QuickJS وإعادة تشغيل جلسة ملتزمة تستهلكان الاستجابات المسجلة دون تكرار callbacks

الطلبات تحفظ الوسائط الموضعية كسلاسل Unicode، بما يشمل وسائط فارغة؛ وتراتب الطلبات يبدأ من الصفر لكل معاملة

المعاملات الفاشلة تستعيد حالة المستند وكائنات السكربت وتخطر callback الإتمام بقيمة Committed=False؛ وعلى التطبيق تجهيز أو تعويض تأثيراته الخارجية لأن تراجع المستند لا يمكنه التراجع عن عملية خارجية

callbacks الإتمام تجري مرة واحدة بعد نجاح تحقق المستند وتخطيطه أو بعد التراجع، قبل مراقبي النجاح الاعتياديين؛ ويجب ألا ترفع callbacks استثناءات أو تعيد الدخول إلى بيئة التشغيل

callbacks المضيف تتطلب جلسة QuickJS المرفقة؛ وcallbacks JavaScriptEvaluator المخصصة لا تزود عقد نقطة الفحص وإعادة التشغيل

عدد الطلبات وعدد الوسائط وبايتات الطلب المرمَّزة وبايتات الاستجابة لها حدود موجبة مستقلة؛ وزمن callback المنقضي يُحسب على مهلة المعاملة، لكن كود التطبيق المتزامن لا يمكن مقاطعته قسرًا

دوال السكربت تتلقى number أو Boolean أو string أو null أو undefined وفق Kind للاستجابة؛ والاستجابات العددية يجب أن تكون منتهية والاستجابات من Unicode يجب أن تحوي ثنائيات surrogate صحيحة

Related APIs

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