AddLinkToResetFormA

التعليقات التوضيحية وروابط النقاط الساخنة، حقول النماذج وAcroForms

الوصف

الحرف المُلحق A يُشير إلى نقطة دخول ANSI (char) في DLL؛ بينما تكشف واجهة ActiveX/COM الشكل Unicode فقط. السلوك مطابق لـ AddLinkToResetForm وتُفسَّر وسائط السلاسل النصية باستخدام صفحة الرموز الحالية لـ SetAnsiMode

يضيف مستطيل نقطة ساخنة قابلًا للنقر إلى الصفحة المحددة يطلق إجراء إعادة تعيين نموذج في PDF عند تنشيطه. ويستعيد إجراء إعادة التعيين حقول AcroForm إلى قيمها الافتراضية دون حاجة إلى JavaScript

استخدم FieldNames لتقييد الحقول المتأثرة بإجراء إعادة التعيين. واترك FieldNames فارغًا ليدع العارض يعيد تعيين كل الحقول المنطبقة

استخدم الدالة SetAnnotBorderColor لتغيير لون إطار النقطة الساخنة

الصيغة

Delphi

Function DLAddLinkToResetFormA(InstanceID: Integer; Left, Top, Width, Height: Double; FieldNames: PAnsiChar; Flags, Options: Integer): Integer;

DLL

int DLAddLinkToResetFormA(int InstanceID, double Left, double Top, double Width, double Height, const char * 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 أو أن المستطيل غير صالح
1تمت إضافة شرح الرابط وإجراء إعادة تعيين النموذج.

ملاحظات

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