AddLinkToResetForm
التعليقات التوضيحية وروابط النقاط الساخنة، حقول النماذج وAcroForms
الوصف
يضيف مستطيل نقطة ساخنة قابلًا للنقر إلى الصفحة المحددة يطلق إجراء إعادة ضبط نموذج في PDF عند تنشيطه. يعيد إجراء إعادة ضبط النموذج حقول AcroForm إلى قيمها الافتراضية دون الحاجة إلى JavaScript استخدم
FieldNames لتقييد الحقول التي يشملها إجراء إعادة الضبط. واترك FieldNames فارغًا ليُعيد العارض ضبط جميع الحقول المنطبقة
استخدم الدالة
SetAnnotBorderColor لتغيير لون حدود النقطة الساخنة
الصيغة
Delphi
Function TPDFlib.AddLinkToResetForm(Left, Top, Width, Height: Double; Const FieldNames: WideString; Flags, Options: Integer): Integer;
DLL
int DLAddLinkToResetForm(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FieldNames, int Flags, int Options);
المعاملات
| Left | الإحداثي الأفقي للحافة اليسرى لمستطيل النقطة الساخنة |
|---|---|
| Top | الإحداثي الرأسي للحافة العلوية لمستطيل النقطة الساخنة |
| Width | عرض مستطيل النقطة الساخنة |
| Height | ارتفاع مستطيل النقطة الساخنة |
| FieldNames | قائمة اختيارية من أسماء حقول AcroForm مؤهَّلة بالكامل مفصولة بفواصل أو فواصل منقوطة أو فواصل أسطر. تُقتطع المسافات البيضاء البادئة واللاحقة حول كل اسم |
| Flags | أعلام إجراء إعادة ضبط النموذج في PDF التي تُكتب في مُدخل /Flags للإجراء. مرّر 0 للسلوك الافتراضي. يستخدم العارضون القياسيون بتات العلم مع /Fields ليقرروا ما إذا كانت القائمة شاملة أم استثنائية |
| Options | قناع بت يتحكم في مظهر الارتباط. البت 0 (القيمة 1): رسم حد حول مستطيل النقطة الساخنة. وتختار البتات 1-3 وضع التمييز عند النقر (2 = Invert، 4 = Outline، 8 = Push)؛ وعند عدم تعيين أي بت تمييز يُستخدم Invert افتراضيًا |
قيم الإرجاع
| 0 | لم يُضف الإجراء لأن المستند في وضع PDF/A أو PDF/X-6، أو لأن المستطيل غير صالح |
|---|---|
| 1 | أُضيف التعليق التوضيحي للرابط وإجراء إعادة ضبط النموذج |
ملاحظات
تحجب أوضاع PDF/A و PDF/X-6 هذا الإجراء؛ وتتطلب الدالة إصدار PDF 1.2 أو أحدث