THPDFPage.AddGoToRStructureDestinationLink Method
Fügt eine Linkannotation hinzu, deren GoToR-Aktion ein Strukturelement in einer externen PDF-Datei über den Byte-String-/ID dieses Elements adressiert und gleichzeitig das erforderliche /D-Fallback-Seitenziel in der Remote-Datei beibehält
Deklaration
procedure AddGoToRStructureDestinationLink(Rectangle: TRect; const FileName: AnsiString;
const RemoteStructElemID: AnsiString; FallbackTargetPageIndex: Integer= 0;
YPos: Single= - 1; NewWindow: boolean= false; const Description: AnsiString= '');Unit
HPDFDoc
Parameter
| Name | Zweck |
|---|---|
Rectangle | Hot-Spot-Rechteck in Seiteneinheiten, in dem der Link aktiv ist |
FileName | Nicht-leerer Pfad zur externen PDF-Datei; Backslashes werden zu Forward-Slashes normalisiert |
RemoteStructElemID | Nicht-leerer Byte-String-/ID des Ziel-StructElem in FileName; muss mit dem /ID übereinstimmen, das diesem Element über die IDStr-Überladung von AddStructureElement zugewiesen wurde |
FallbackTargetPageIndex | Erforderlicher nullbasierter Seitenindex in der Remote-Datei, der vom /D-Fallback-Ziel verwendet wird; muss >= 0 sein |
YPos | Optionale vertikale Position für den /XYZ-Fit; einen negativen Wert übergeben, um sie null zu lassen |
NewWindow | Wenn true, wird /NewWindow true ausgegeben, sodass der Viewer das Ziel in einem neuen Fenster öffnet |
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 - Remote-Strukturziele können ein fremdes StructElem nicht per Pointer referenzieren, daher verlangt ISO 32000-2 §12.3.2.3, dass das erste
/SD-Element der Byte-String-/IDdes Zielelements ist; die ausgegebene Literal-String-Form entspricht der/ID-Form, dieAddStructureElementfür denselbenIDStrerzeugt - Gibt eine GoToR-Aktion mit
/F, einem erforderlichen/D-Fallback-Ziel und dem/SD-Byte-String-Array aus - Ein leeres
FileName, ein leeresRemoteStructElemIDoder ein negativesFallbackTargetPageIndexwird ausgelöst, bevor irgendeine Annotation oder ein Versionsbump ausgegeben wird