AddLinkToResetForm
حاشیهنویسیها و پیوندهای نقطه داغ, فیلدهای فرم و 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 = Invert، 4 = Outline، 8 = Push)؛ هنگامی که هیچ بیتی برجسته تنظیم نشده باشد، Invert به عنوان پیشفرض استفاده میشود |
مقدار بازگشتی
| 0 | عمل اضافه نشد زیرا سند در حالت PDF/A است یا مستطیل نامعتبر است |
|---|---|
| 1 | حاشیهنویسی پیوند و عمل فرم بازنشانی اضافه شدند |
یادداشتها
حالت PDF/A این عمل را مسدود میکند زیرا عملکردهای تعاملی فرم برای انطباق بایگانی مناسب نیستند. این تابع به PDF 1.2 یا بالاتر نیاز دارد