THPDFPage.AddStructureDestinationLink Method
Fügt eine Linkannotation hinzu, deren GoTo-Aktion das erforderliche /D-Fallback-Ziel auf Seitenkoordinaten und das PDF-2.0-/SD-Array trägt, das das Ziel-StructElem per indirekter Referenz benennt, sodass PDF-2.0-Viewer zum Strukturinhalt springen, während ältere Viewer auf die benannte Seite zurückfallen
Deklaration
procedure AddStructureDestinationLink(Rectangle: TRect; StructElem: THPDFDictionaryObject;
FallbackPageIndex: Integer; YPos: Single= - 1; const Description: AnsiString= '');Unit
HPDFDoc
Parameter
| Name | Zweck |
|---|---|
Rectangle | Hot-Spot-Rechteck in Seiteneinheiten, in dem der Link aktiv ist |
StructElem | Nicht-nil-indirektes StructElem-Wörterbuch als Ziel, typischerweise aus AddStructureElement oder FindStructureElementForMCID |
FallbackPageIndex | Erforderlicher Seitenindex, den das /D-Explizitziel für Nicht-PDF-2.0-Viewer verwendet |
YPos | Optionale vertikale Position für den /XYZ-Fit; einen negativen Wert übergeben, um sie null zu lassen |
Description | Alternative Beschreibung, die in /Contents der Annotation gespeichert wird; unter PDFUACompliance erforderlich |
Rückgabewert
Dieses Member gibt keinen Wert zurück
Verhalten
- Erfordert PDF 2.0 (ISO 32000-2) und folgt dem
StrictVersionLock-Verhalten, da/SDein PDF-2.0-Aktions-Eintrag ist - Gibt eine GoTo-Aktion mit
/Din derselben[page /XYZ null y null]-Form wieAddGoToLinksowie ein ein-elementiges/SD-Array aus, das die indirekte StructElem-Referenz enthält - Ein
nil-StructElem oder ein außerhalb des Bereichs liegenderFallbackPageIndexwird ausgelöst, bevor irgendeine Annotation oder ein Versionsbump ausgegeben wird - Unter
PDFUACompliancewird ein leeresDescriptiongemäß PDF/UA-1 §7.18.5 ausgelöst