AddLinkToSubmitForm
حاشیهنویسیها و پیوندهای نقطه داغ, فیلدهای فرم و 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 عمل نوشته شدهاند. برای ارسال به سبک FDF پیشفرض 0 را پاس دهید. بیتهای استاندارد رایج شامل 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 یا بالاتر نیاز دارد