THPDFPage.AddStructureDestinationLink Method
Ajoute une annotation de lien dont l'action GoTo porte la destination de repli /D à coordonnées de page requise et le tableau PDF 2.0 /SD nommant l'élément StructElem cible par référence indirecte, de sorte que les visualiseurs PDF 2.0 sautent vers le contenu de structure tandis que les visualiseurs hérités retombent sur la page nommée
Déclaration
procedure AddStructureDestinationLink(Rectangle: TRect; StructElem: THPDFDictionaryObject;
FallbackPageIndex: Integer; YPos: Single= - 1; const Description: AnsiString= '');Unité
HPDFDoc
Paramètres
| Nom | Rôle |
|---|---|
Rectangle | Rectangle actif en unités de page où le lien est actif |
StructElem | Dictionnaire StructElem indirect non nul à cibler, généralement issu de AddStructureElement ou de FindStructureElementForMCID |
FallbackPageIndex | Index de page requis utilisé par la destination explicite /D pour les visualiseurs non PDF 2.0 |
YPos | Position verticale facultative pour l'ajustement /XYZ ; passez une valeur négative pour la laisser nulle |
Description | Description alternative stockée dans le /Contents de l'annotation ; requise sous PDFUACompliance |
Valeur de retour
Ce membre ne renvoie pas de valeur
Comportement
- Exige le PDF 2.0 (ISO 32000-2) et suit le comportement
StrictVersionLock, puisque/SDest une entrée d'action PDF 2.0 - Émet une action GoTo avec
/Ddans la même forme[page /XYZ null y null]queAddGoToLink, plus un tableau/SDà un seul élément contenant la référence indirecte StructElem - Un StructElem
nilou unFallbackPageIndexhors plage lève une exception avant qu'aucune annotation ni incrément de version ne soit émis - Sous
PDFUACompliance, unDescriptionvide lève une exception conformément au PDF/UA-1 §7.18.5