AddLinkToHideField
التعليقات التوضيحية وروابط النقاط الساخنة، حقول النماذج وAcroForms
الوصف
يضيف مستطيل نقطة ساخنة قابلًا للنقر إلى الصفحة المحددة يطلق إجراء إخفاء في PDF عند تنشيطه؛ إجراء الإخفاء يبدل ظهور حقل AcroForm واحد أو أكثر مما يتيح سلوك إظهار/إخفاء ديناميكي بلا JavaScript؛ ويُعرَّف الإجراء في ISO 32000-1 §12.6.4.10, Table 196
استخدام نمطي: رابط «إظهار التفاصيل» / «إخفاء التفاصيل» في تخطيط نموذج، أو مجموعات حقول متنافية حيث يخفي نقر رابط مجموعة ويعرض أخرى (اجمع استدعائي AddLinkToHideField بقيمتي HideFlag متعاكستين)
استخدم دالة 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 أو أحدث