THPDFPage.AddGoToRStructureDestinationLink Method
Voegt een koppelingsannotatie toe waarvan de GoToR-actie een structuurelement in een externe PDF als doel heeft via de bytestring-/ID van dat element, terwijl de vereiste /D-fallback-paginabestemming in het externe bestand blijft
Declaratie
procedure AddGoToRStructureDestinationLink(Rectangle: TRect; const FileName: AnsiString;
const RemoteStructElemID: AnsiString; FallbackTargetPageIndex: Integer= 0;
YPos: Single= - 1; NewWindow: boolean= false; const Description: AnsiString= '');Eenheid
HPDFDoc
Parameters
| Naam | Doel |
|---|---|
Rectangle | Hotspot-rechthoek in pagina-eenheden waar de koppeling actief is |
FileName | Niet-lege pad naar de externe PDF; backslashes worden genormaliseerd naar forward slashes |
RemoteStructElemID | Niet-lege bytestring-/ID van het doel-StructElem in FileName; moet overeenkomen met de /ID die op dat element is gestempeld via de IDStr-overload van AddStructureElement |
FallbackTargetPageIndex | Vereiste nul-gebaseerde pagina-index in het externe bestand die door de /D-fallback-bestemming wordt gebruikt; moet >= 0 zijn |
YPos | Optionele verticale positie voor de /XYZ-passing; geef een negatieve waarde door om deze null te laten |
NewWindow | Wanneer waar, wordt /NewWindow true uitgevoerd zodat de viewer het doel in een nieuw venster opent |
Description | Alternatieve beschrijving die in de annotatie-/Contents wordt opgeslagen; vereist onder PDFUACompliance |
Retourwaarde
Dit lid retourneert geen waarde
Gedrag
- Vereist PDF 2.0 (ISO 32000-2) en volgt het
StrictVersionLock-gedrag - Externe structuurdoelen kunnen niet naar een extern StructElem verwijzen via een pointer, dus vereist ISO 32000-2 ยง12.3.2.3 dat het eerste
/SD-element de bytestring-/IDvan het doelelement is; de uitgevoerde literal-string-vorm komt overeen met de/ID-vorm dieAddStructureElementvoor dezelfdeIDStrproduceert - Voert een GoToR-actie uit met
/F, een vereiste/D-fallback-bestemming en de/SD-bytestring-array - Een lege
FileName, legeRemoteStructElemIDof negatieveFallbackTargetPageIndexveroorzaakt een fout voordat er een annotatie of versieverhoging wordt uitgevoerd