THPDFPage.AddStructureDestinationLink Method
يضيف annotation من نوع رابط يحمل إجراؤه GoTo وجهة احتياطية مطلوبة /D بإحداثيات الصفحة، ومصفوفة /SD الخاصة بـPDF 2.0 التي تسمّي StructElem الهدف عبر مرجع غير مباشر، بحيث تنتقل عارضات PDF 2.0 إلى محتوى البنية بينما تعود العارضات القديمة إلى الصفحة المسمّاة
التصريح
procedure AddStructureDestinationLink(Rectangle: TRect; StructElem: THPDFDictionaryObject;
FallbackPageIndex: Integer; YPos: Single= - 1; const Description: AnsiString= '');
الوحدة
HPDFDoc
الوحدة
| المرجع | المرجع |
|---|---|
Rectangle | مستطيل المنطقة النشطة بوحدات الصفحة الذي يكون الرابط فعّالًا داخله |
StructElem | قاموس StructElem غير مباشر وغير nil يُستهدف، ويأتي عادةً من AddStructureElement أو FindStructureElementForMCID |
FallbackPageIndex | فهرس الصفحة المطلوب الذي تستخدمه الوجهة الصريحة /D مع العارضات التي لا تدعم PDF 2.0 |
YPos | موضع رأسي اختياري لملاءمة /XYZ؛ مرّر قيمة سالبة لتركه null |
Description | وصف بديل يُخزَّن في /Contents الخاص بالتعليق التوضيحي؛ وهو مطلوب تحت PDFUACompliance |
الوحدة
لا يُرجع هذا العضو أي قيمة
الوحدة
- يتطلب PDF 2.0 (ISO 32000-2) ويتبع سلوك
StrictVersionLock، بما أن/SDمدخلة إجراء خاصة بـPDF 2.0 - يُصدِر إجراء GoTo مع
/Dبنفس شكل[page /XYZ null y null]المستخدَم فيAddGoToLink، بالإضافة إلى مصفوفة/SDذات عنصر واحد تحمل مرجع StructElem غير المباشر - يؤدي تمرير StructElem بقيمة
nilأوFallbackPageIndexخارج النطاق إلى إطلاق استثناء قبل إصدار أي تعليق توضيحي أو رفع إصدار - تحت
PDFUAComplianceيُطلقDescriptionالفارغ استثناءً وفقًا لـPDF/UA-1 §7.18.5