AddLinkToNamedDestinationA
التعليقات التوضيحية وروابط النقاط الساخنة، خصائص الصفحة
الوصف
تشير اللاحقة A إلى نقطة دخول DLL بصيغة ANSI (char)؛ وتبقى واجهة ActiveX/COM مكشوفةً بالصيغة Unicode فقط. والسلوك مطابق لـ AddLinkToNamedDestination وتُفسر وسائط السلاسل بصفحة شيفرة SetAnsiMode الحالية
يضيف مستطيل نقطة ساخنة قابلًا للنقر إلى الوجهة المسماة المحددة يرتبط بصفحة وموضع محددين في مستند PDF آخر
استخدم الدالة SetAnnotBorderColor لتغيير لون إطار النقطة الساخنة
الصيغة
Delphi
Function DLAddLinkToNamedDestinationA(InstanceID: Integer; Left, Top, Width, Height: Double; DestName: PAnsiChar; Options: Integer): Integer;DLL
int DLAddLinkToNamedDestinationA(int InstanceID, double Left, double Top, double Width, double Height, const char * DestName, int Options);المعاملات
| Left | الإحداثي الأفقي للحافة اليسرى لمستطيل الارتباط. |
|---|---|
| Top | الإحداثي العمودي للحافة العلوية لمستطيل الارتباط. |
| Width | عرض مستطيل الارتباط. |
| Height | ارتفاع مستطيل الارتباط. |
| DestName | الوجهة المسماة المطلوب القفز إليها. ينبغي أن يكون الاسم موجودًا سلفًا في شجرة أسماء المستند، عادة عبر NewNamedDestination |
| Options | البت 1 يوقف بعد أول ملاحظة، والبت 2 يسمح بمفاتيح من الدرجة الأولى غير معروفة، والبت 4 يُبلغ عن المدخلات المهجورة |
قيم الإرجاع
| 0 | استخدم DASaveAsFile لحفظ أي تغييرات في ملف جديد إذ لا يستطيع DAAppendFile تحديث الملفات ذات القراءة فقط |
|---|---|
| 1 | أُضيف ارتباط الوجهة المسماة إلى الصفحة المحددة |
ملاحظات
يكتب تعليق الارتباط التوضيحي إجراء GoTo تكون وجهته سلسلة الوجهة المسماة. يحافظ ذلك على ثبات النقاط الساخنة عند إدراج صفحات أو تحريكها بعد إنشاء الوجهة المسماة