THPDFPage.AddStructureDestinationLink Method
Aggiunge un'annotazione di link la cui azione GoTo porta la destinazione di fallback /D a coordinate di pagina richiesta e l'array /SD PDF 2.0 che nomina lo StructElem target tramite riferimento indiretto, così i viewer PDF 2.0 saltano al contenuto della struttura mentre i viewer legacy ricadono sulla pagina indicata
Dichiarazione
procedure AddStructureDestinationLink(Rectangle: TRect; StructElem: THPDFDictionaryObject;
FallbackPageIndex: Integer; YPos: Single= - 1; const Description: AnsiString= '');Unità
HPDFDoc
Parametri
| Nome | Scopo |
|---|---|
Rectangle | Rettangolo hotspot in unità di pagina in cui il link è attivo |
StructElem | Dizionario StructElem indiretto non nil da puntare, tipicamente proveniente da AddStructureElement o FindStructureElementForMCID |
FallbackPageIndex | Indice di pagina richiesto usato dalla destinazione esplicita /D per i viewer non PDF 2.0 |
YPos | Posizione verticale opzionale per il fit /XYZ; passa un valore negativo per lasciarlo null |
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, poiché/SDè una voce d'azione PDF 2.0 - Emette un'azione GoTo con
/Dnella stessa forma[page /XYZ null y null]diAddGoToLinkpiù un array/SDa elemento singolo che contiene il riferimento indiretto allo StructElem - Uno StructElem
nilo unFallbackPageIndexfuori intervallo sollevano un'eccezione prima che venga emessa qualsiasi annotazione o incremento di versione - Con
PDFUAComplianceunaDescriptionvuota solleva un'eccezione secondo PDF/UA-1 §7.18.5