AddLinkToResetForm

Annotations and hotspot links, Form fields and 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 = عكس، 4 = مخطط تفصيلي، 8 = دفع)؛ عند عدم تعيين أي بت إبراز، يتم استخدام Invert كإعداد افتراضي.

قيمة الإرجاع

0	لم تتم إضافة الإجراء لأن المستند في وضع PDF/A أو أن المستطيل غير صالح.
1	تمت إضافة شرح الرابط وإجراء إعادة تعيين النموذج.

ملاحظات

يمنع وضع PDF/A هذا الإجراء لأن نماذج الإجراءات التفاعلية غير مناسبة للتوافق الأرشيفي. تتطلب الدالة PDF 1.2 أو أحدث.