AddLinkToSubmitForm

Annotations and hotspot links, Form fields and AcroForms

الوصف

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

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

استخدم الدالة SetAnnotBorderColor لتغيير لون حدود الارتباط

بناء الجملة

Delphi

Function TPDFlib.AddLinkToSubmitForm(Left, Top, Width, Height: Double; Const URL, FieldNames: WideString; Flags, Options: Integer): Integer;

DLL

int DLAddLinkToSubmitForm(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * URL, const wchar_t * FieldNames, int Flags, int Options);

المعلمات

Left	الإحداثي الأفقي للحافة اليسرى لمستطيل الارتباط.
Top	الإحداثي العمودي للحافة العلوية لمستطيل الارتباط.
Width	عرض مستطيل الارتباط.
Height	ارتفاع مستطيل الارتباط.
URL	عنوان URL لهدف الإرسال المخزن في مواصفات ملف الإجراء
FieldNames	قائمة اختيارية بأسماء حقول AcroForm المؤهلة بالكامل مفصولة بفواصل أو فواصل منقوطة أو فواصل أسطر. يتم اقتطاع المسافات البادئة واللاحقة حول كل اسم
Flags	علامات إجراء إرسال نموذج PDF المكتوبة في إدخال `/Flags` الخاص بالإجراء. قم بتمرير 0 لتقديم نمط FDF الافتراضي. تتضمن بتات القياسية الشائعة 4 لتنسيق HTML و 32 لـ XFDF و 256 لتقديم مستند PDF بالكامل
Options	قناع بت يتحكم في مظهر الرابط. البت 0 (القيمة 1): رسم حد حول مستطيل الارتباط. تحدد البتات 1-3 وضع إبراز النقر (2 = عكس، 4 = مخطط تفصيلي، 8 = دفع)؛ عند عدم تعيين أي بت إبراز، يتم استخدام Invert كإعداد افتراضي

قيمة الإرجاع

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

ملاحظات

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