THPDFPage.AddGoToRStructureDestinationLink Method
Aggiunge un'annotazione di link la cui azione GoToR punta a un elemento di struttura in un PDF esterno tramite il /ID come byte-string di quell'elemento, mantenendo nel file remoto la destinazione di pagina di fallback /D richiesta
Dichiarazione
procedure AddGoToRStructureDestinationLink(Rectangle: TRect; const FileName: AnsiString;
const RemoteStructElemID: AnsiString; FallbackTargetPageIndex: Integer= 0;
YPos: Single= - 1; NewWindow: boolean= false; const Description: AnsiString= '');Unità
HPDFDoc
Parametri
| Nome | Scopo |
|---|---|
Rectangle | Rettangolo hotspot in unità di pagina in cui il link è attivo |
FileName | Percorso non vuoto verso il PDF esterno; le barre rovesce vengono normalizzate in barre |
RemoteStructElemID | /ID come byte-string non vuoto dello StructElem target in FileName; deve corrispondere all'/ID stampato su quell'elemento tramite l'overload IDStr di AddStructureElement |
FallbackTargetPageIndex | Indice di pagina a base zero richiesto nel file remoto usato dalla destinazione di fallback /D; deve essere >= 0 |
YPos | Posizione verticale opzionale per il fit /XYZ; passa un valore negativo per lasciarlo null |
NewWindow | Se true, emette /NewWindow true così il viewer apre il target in una nuova finestra |
Description | Descrizione alternativa memorizzata in /Contents dell'annotazione; richiesta con PDFUACompliance |
Valore restituito
Questo membro non restituisce un valore
Comportamento
- Richiede PDF 2.0 (ISO 32000-2) e segue il comportamento di
StrictVersionLock - I target di struttura remoti non possono riferirsi a uno StructElem esterno tramite puntatore, quindi ISO 32000-2 §12.3.2.3 richiede che il primo elemento di
/SDsia il/IDcome byte-string dell'elemento target; la forma a stringa letterale emessa corrisponde alla forma/IDcheAddStructureElementproduce per lo stessoIDStr - Emette un'azione GoToR con
/F, una destinazione di fallback/Drichiesta e l'array/SDdi byte-string - Un
FileNamevuoto, unoRemoteStructElemIDvuoto o unFallbackTargetPageIndexnegativo sollevano un'eccezione prima che venga emessa qualsiasi annotazione o avanzamento di versione