AddLinkToImportData
التعليقات التوضيحية وروابط النقاط الساخنة، حقول النماذج وAcroForms
الوصف
يضيف مستطيل نقطة ساخنة قابلًا للنقر إلى الصفحة المحددة يطلق إجراء استيراد بيانات في PDF عند تنشيطه؛ إجراء استيراد البيانات يملأ حقول AcroForm في المستند من ملف Forms Data Format (FDF) على القرص؛ ويُعرَّف الإجراء في ISO 32000-1 §12.6.4.8, Table 198
استخدام نمطي: رابط «إعادة تحميل بيانات العينة» أو «استعادة الافتراضات» في نموذج تفاعلي، حيث يرفق ملف FDF بجوار PDF ويحوي قيم الحقول القياسية
استخدم دالة SetAnnotBorderColor لتغيير لون حدود النقطة الساخنة
الصيغة
Delphi
Function TPDFlib.AddLinkToImportData(Left, Top, Width, Height: Double; Const FileName: WideString; Options: Integer): Integer;DLL
int DLAddLinkToImportData(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FileName, int Options);المعاملات
| Left | الإحداثي الأفقي للحافة اليسرى لمستطيل النقطة الساخنة |
|---|---|
| Top | الإحداثي الرأسي للحافة العلوية لمستطيل النقطة الساخنة |
| Width | عرض مستطيل النقطة الساخنة |
| Height | ارتفاع مستطيل النقطة الساخنة |
| FileName | المسار إلى ملف FDF الذي ستُعبَّأ منه حقول النموذج. تُحوَّل الخطوط المائلة العكسية إلى خطوط مائلة أمامية وفق صيغة المسار القانونية في PDF حسب ISO 32000-1 §7.11.2.1. لا يلزم وجود الملف عند إنشاء PDF لكن يجب أن يكون موجودًا وقت العرض كي ينجح الإجراء |
| Options | قناع بت يتحكم في مظهر الارتباط. البت 0 (القيمة 1): رسم حد حول مستطيل النقطة الساخنة. وتختار البتات 1–3 وضع التمييز عند النقر (2 = Invert، 4 = Outline، 8 = Push)؛ وعند عدم تعيين أي بت تمييز يُستخدم Invert افتراضيًا. الاتفاقية نفسها المستخدمة في AddLinkToWeb / AddLinkToHideField |
ملاحظات
ترفض أوضاع PDF/A و PDF/X-6 إجراءات ImportData وتُرجع 0 دون إضافة تعليق توضيحي؛ ويلزم إصدار PDF 1.4 أو أحدث