AddLinkToImportData
حاشیهنویسیها و پیوندهای نقطهٔ فعال، فیلدهای فرم و AcroForms
توضیحات
مستطیل ناحیهٔ داغ قابلکلیک به صفحهٔ انتخابشده اضافه میکند که هنگام فعالسازی عمل واردکردن-دادهٔ PDF را راه میاندازد؛ عمل واردکردن-داده فیلدهای AcroForm سند را از یک فایل Forms Data Format (FDF) روی دیسک پر میکند؛ این عمل در ISO 32000-1 §12.6.4.8، جدول 198 تعریف شده است
کاربرد معمول: پیوند «بارگذاری دوبارهٔ دادهٔ نمونه» یا «بازگردانی به پیشفرضها» در فرمی تعاملی، جایی که فایل FDF کنار PDF میآید و مقدارهای مرجع فیلدها را در بر دارد
برای تغییر رنگ کادر ناحیهٔ داغ از تابع SetAnnotBorderColor استفاده کنید
نحو
Delphi
Function TPDFlib.AddLinkToImportData(Left, Top, Width, Height: Double; Const FileName: WideString; Options: Integer): Integer;DLL
int DLAddLinkToImportData(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FileName, int Options);پارامترها
| Left | مختصات افقی لبهٔ چپ مستطیل نقطهٔ فعال |
|---|---|
| Top | مختصات عمودی لبهٔ بالای مستطیل نقطهٔ فعال |
| Width | عرض مستطیل نقطهٔ فعال |
| Height | ارتفاع مستطیل نقطهٔ فعال |
| FileName | مسیر فایل FDF که فیلدهای فرم از آن پر میشوند. بکاسلشها مطابق قالب مسیر کانونیک PDF در ISO 32000-1 §7.11.2.1 به اسلش تبدیل میشوند. لازم نیست فایل در زمان ساخت PDF موجود باشد، اما برای موفقیت کنش باید هنگام مشاهده حاضر باشد |
| Options | ماسک بیتی برای کنترل ظاهر پیوند. بیت 0 (مقدار 1): ترسیم خط دور مستطیل نقطهٔ فعال. بیتهای 1–3 حالت برجستهسازی کلیک را برمیگزینند (2 = Invert، 4 = Outline، 8 = Push)؛ وقتی هیچ بیت برجستهسازی تنظیم نشده باشد Invert بهعنوان پیشفرض بهکار میرود. قراردادی همانند AddLinkToWeb / AddLinkToHideField |
ملاحظات
حالتهای PDF/A و PDF/X-6 کنشهای ImportData را رد میکنند و بدون افزودن حاشیهنویسی 0 برمیگردانند؛ PDF 1.4 یا جدیدتر لازم است