THPDFPage.AddGoToRStructureDestinationLink Method
Lägger till en länkanteckning vars GoToR-åtgärd riktar in sig på ett strukturelement i en extern PDF via byte-strängens /ID för det elementet, samtidigt som den obligatoriska /D-fallback-sidestinationen i fjärrfilen behålls
Deklaration
procedure AddGoToRStructureDestinationLink(Rectangle: TRect; const FileName: AnsiString;
const RemoteStructElemID: AnsiString; FallbackTargetPageIndex: Integer= 0;
YPos: Single= - 1; NewWindow: boolean= false; const Description: AnsiString= '');Enhet
HPDFDoc
Parametrar
| Name | Purpose |
|---|---|
Rectangle | Klickruta i sidenheter där länken är aktiv |
FileName | Icke-tom sökväg till den externa PDF:en; omvänt snedstreck normaliseras till snedstreck |
RemoteStructElemID | Icke-tom byte-sträng /ID för mål-StructElem i FileName; måste matcha det /ID som stämplats på elementet via IDStr-överlagringen i AddStructureElement |
FallbackTargetPageIndex | Obligatoriskt nollbaserat sidindex i fjärrfilen som används av /D-fallbackdestinationen; måste vara >= 0 |
YPos | Valfri vertikal position för /XYZ-passningen; skicka ett negativt värde för att lämna det null |
NewWindow | När true, sänder /NewWindow true så att visaren öppnar målet i ett nytt fönster |
Description | Alternativ beskrivning som lagras i anteckningens /Contents; obligatorisk under PDFUACompliance |
Returvärde
Denna medlem returnerar inget värde
Beteende
- Kräver PDF 2.0 (ISO 32000-2) och följer
StrictVersionLock-beteendet - Fjärrstående strukturmål kan inte referera ett främmande StructElem via pekare, så ISO 32000-2 §12.3.2.3 kräver att det första
/SD-elementet är byte-strängens/IDför mål-elementet; den sända literal-strängformen matchar den/ID-form somAddStructureElementproducerar för sammaIDStr - Sänder en GoToR-åtgärd med
/F, en obligatorisk/D-fallbackdestination och/SD-byte-sträng-arrayen - En tom
FileName, tomRemoteStructElemIDeller negativFallbackTargetPageIndexhöjer ett undantag innan någon anteckning eller versionshöjning sänds