AddLinkToSubmitFormA

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

الوصف

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

يضيف مستطيل نقطة ساخنة قابلًا للنقر إلى الصفحة المحددة يرتبط بمسار نسبي بصفحة وموضع محددين في مستند PDF آخر. استخدم الدالة SetAnnotBorderColor لتغيير لون إطار النقطة الساخنة

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

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

الصيغة

Delphi

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

DLL

int DLAddLinkToSubmitFormA(int InstanceID, double Left, double Top, double Width, double Height, const char * URL, const char * 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 = Invert، 4 = Outline، 8 = Push)؛ وعند عدم تعيين أي بت تمييز يُستخدم Invert كافتراضي

قيم الإرجاع

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

ملاحظات

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