THPDFPage.AddStructureDestinationLink Method
Zorunlu page-coordinate /D fallback destination'ını ve hedef StructElem'i indirect reference ile adlayan PDF 2.0 /SD array'ini taşıyan GoTo action'lı bir link annotation ekler; böylece PDF 2.0 viewer'lar structure içeriğine atlar, eski viewer'lar adlanan sayfaya geri düşer
Bildirim
procedure AddStructureDestinationLink(Rectangle: TRect; StructElem: THPDFDictionaryObject;
FallbackPageIndex: Integer; YPos: Single= - 1; const Description: AnsiString= '');
Birim
HPDFDoc
Parametreler
| Ad | Amaç |
|---|---|
Rectangle | Bağlantının etkin olduğu page unit cinsinden hot-spot dikdörtgeni |
StructElem | Hedeflenecek non-nil indirect StructElem dictionary'si; tipik olarak AddStructureElement veya FindStructureElementForMCID kaynağından gelir |
FallbackPageIndex | PDF 2.0 öncesi viewer'lar için /D explicit destination'ının kullandığı zorunlu sayfa indeksi |
YPos | /XYZ fit için isteğe bağlı dikey konum; null bırakmak için negatif bir değer geçirin |
Description | Annotation /Contents içinde saklanan alternatif açıklama; PDFUACompliance altında zorunludur |
Dönüş değeri
Bu üye değer döndürmez
Davranış
- PDF 2.0 (ISO 32000-2) gerektirir ve
StrictVersionLockdavranışını izler; çünkü/SDbir PDF 2.0 action girdisidir AddGoToLinkile aynı[page /XYZ null y null]biçiminde/Dtaşıyan ve indirect StructElem reference'ını tutan tek elementli/SDarray'i içeren bir GoTo action yayar- Bir
nilStructElem veya aralık dışı birFallbackPageIndex; herhangi bir annotation veya version bump yayılmadan önce exception fırlatır PDFUACompliancealtında boş birDescription, PDF/UA-1 §7.18.5 uyarınca exception fırlatır