AddLinkToHideFieldA
التعليقات التوضيحية وروابط النقاط الساخنة، حقول النماذج وAcroForms
الوصف
تشير اللاحقة A إلى نقطة دخول DLL بصيغة ANSI (char)؛ وتبقى واجهة ActiveX/COM مكشوفةً بالصيغة Unicode فقط. والسلوك مطابق لـ AddLinkToHideField وتُفسر وسائط السلاسل بصفحة شيفرة SetAnsiMode الحالية
يضيف مستطيل نقطة ساخنة قابلًا للنقر إلى الصفحة المحددة يطلق إجراء إخفاء في PDF عند تنشيطه. و يبدل إجراء الإخفاء ظهور حقل AcroForm واحد أو أكثر، مما يتيح سلوك إظهار/إخفاء ديناميكي دون JavaScript. ويُعرَّف الإجراء في ISO 32000-1 §12.6.4.10, Table 196
الاستخدام النموذجي: ارتباط “إظهار التفاصيل” / “إخفاء التفاصيل” في تخطيط نموذج، أو مجموعات حقول متعارضة حيث يخفي النقر على ارتباط واحد مجموعة ويعرض أخرى (ادمج استدعاءَي AddLinkToHideField بقيمتَي HideFlag متعاكستين)
استخدم الدالة SetAnnotBorderColor لتغيير لون إطار النقطة الساخنة
الصيغة
Delphi
Function DLAddLinkToHideFieldA(InstanceID: Integer; Left, Top, Width, Height: Double; FieldNames: PAnsiChar; HideFlag, Options: Integer): Integer;DLL
int DLAddLinkToHideFieldA(int InstanceID, double Left, double Top, double Width, double Height, const char * 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 1.2 أو أحدث