AddLinkToHideField
حاشیهنویسیها و پیوندهای نقطهٔ فعال، فیلدهای فرم و AcroForms
توضیحات
مستطیل ناحیهٔ داغ قابلکلیک به صفحهٔ انتخابشده اضافه میکند که هنگام فعالسازی عمل پنهانسازی PDF را راه میاندازد؛ عمل پنهانسازی دیدپذیری یک یا چند فیلد AcroForm را عوض میکند و رفتار پویای نشاندادن/پنهانکردن بدون جاوااسکریپت ممکن میشود؛ این عمل در ISO 32000-1 §12.6.4.10، جدول 196 تعریف شده است
کاربرد معمول: پیوند «نمایش جزئیات» / «پنهانکردن جزئیات» در چیدمان فرم، یا گروههای فیلد متقابلاً-منحصربهفرد که کلیک یک پیوند گروهی را پنهان و گروهی را نشان میدهد (دو فراخوانی AddLinkToHideField با مقدارهای Hide مخالف را ترکیب کنید)
برای تغییر رنگ کادر ناحیهٔ داغ از تابع SetAnnotBorderColor استفاده کنید
نحو
Delphi
Function TPDFlib.AddLinkToHideField(Left, Top, Width, Height: Double; Const FieldNames: WideString; HideFlag: Integer; Options: Integer): Integer;DLL
int DLAddLinkToHideField(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FieldNames, int HideFlag, int Options);پارامترها
| Left | مختصات افقی لبهٔ چپ مستطیل نقطهٔ فعال |
|---|---|
| Top | مختصات عمودی لبهٔ بالای مستطیل نقطهٔ فعال |
| Width | عرض مستطیل نقطهٔ فعال |
| Height | ارتفاع مستطیل نقطهٔ فعال |
| FieldNames | یک یا چند نام کامل فیلد AcroForm، جداشده با ویرگول، نقطهویرگول یا خط جدید. فاصلههای ابتدا و انتهای هر نام حذف میشود. یک نام منفرد /T را بهصورت رشتهٔ متنی صادر میکند و دو نام یا بیشتر /T را بهصورت آرایهای از رشتههای متنی |
| HideFlag | جهت نمایانی را برمیگزیند. مقدار غیرصفر فیلدهای فهرستشده را پنهان میکند (/H true) و صفر آنها را نمایش میدهد (/H false) |
| Options | ماسک بیتی برای کنترل ظاهر پیوند. بیت 0 (مقدار 1): ترسیم خط دور مستطیل نقطهٔ فعال. بیتهای 1–3 حالت برجستهسازی کلیک را برمیگزینند (2 = Invert، 4 = Outline، 8 = Push)؛ وقتی هیچ بیت برجستهسازی تنظیم نشده باشد Invert بهعنوان پیشفرض بهکار میرود. قراردادی همانند AddLinkToWeb / AddLinkToNamedAction |
ملاحظات
حالتهای PDF/A و PDF/X-6 کنشهای Hide را رد میکنند و 0 برمیگردانند؛ PDF 1.2 یا جدیدتر لازم است