AddLinkToNamedAction
التعليقات التوضيحية وروابط النقاط الساخنة، خصائص الصفحة
الوصف
يضيف مستطيل نقطة ساخنة قابلًا للنقر إلى الصفحة المحددة يطلق إجراء PDF مسمى عند تنشيطه. والإجراءات المسماة أوامر تنقل يتحكم فيها العارض معرَّفة في ISO 32000-1 §12.6.4.11, Table 194. والأسماء القياسية الأربعة المدعومة هي NextPage وPrevPage وFirstPage وLastPage. وعلى خلاف AddLinkToPage لا يلزم رقم صفحة وجهة صريح — بل يفسر العارض الأمر عند التشغيل
الاستخدام النموذجي: أزرار تنقل (التالي / السابق / البداية / النهاية) على ترويسة صفحة أو تذييلها، حيث تكون الوجهة نسبيةً إلى الصفحة التي يعرضها العارض حاليًا
استخدم الدالة SetAnnotBorderColor لتغيير لون إطار النقطة الساخنة
الصيغة
Delphi
Function TPDFlib.AddLinkToNamedAction(Left, Top, Width, Height: Double; NamedActionType: Integer; Options: Integer): Integer;DLL
int DLAddLinkToNamedAction(int InstanceID, double Left, double Top, double Width, double Height, int NamedActionType, int Options);المعاملات
| Left | الإحداثي الأفقي للحافة اليسرى لمستطيل الارتباط. |
|---|---|
| Top | الإحداثي العمودي للحافة العلوية لمستطيل الارتباط. |
| Width | عرض مستطيل الارتباط. |
| Height | ارتفاع مستطيل الارتباط. |
| NamedActionType | يختار الإجراء المسمى المطلوب إطلاقه: 0 = NextPage، 1 = PrevPage، 2 = FirstPage، 3 = LastPage. وتعود القيم خارج هذا المدى إلى NextPage فيُصدر الكاتب دائمًا اسم /N ممتثلًا للمواصفة |
| Options | قناع بتات يتحكم في مظهر الرابط. البت 0 (القيمة 1): يرسم حدًا حول مستطيل النقطة الفعالة. تختار البتات 1–3 وضع تمييز النقر (2 = Invert، 4 = Outline، 8 = Push)؛ عند عدم تعيين أي بت للتمييز يُستخدم Invert افتراضيًا. نفس الاصطلاح المستخدم في AddLinkToWeb / AddLinkToPage |
ملاحظات
التعليق التوضيحي متوافق مع PDF/A لأنه لا يشير إلى مورد خارجي. مطلوب PDF 1.1 أو أحدث