THPDFPage.AddGoToRStructureDestinationLink Method
Ajoute une annotation de lien dont l'action GoToR cible un élément de structure dans un PDF externe via la chaîne d'octets /ID de cet élément, tout en conservant la destination de repli de page /D requise dans le fichier distant
Déclaration
procedure AddGoToRStructureDestinationLink(Rectangle: TRect; const FileName: AnsiString;
const RemoteStructElemID: AnsiString; FallbackTargetPageIndex: Integer= 0;
YPos: Single= - 1; NewWindow: boolean= false; const Description: AnsiString= '');Unité
HPDFDoc
Paramètres
| Nom | Rôle |
|---|---|
Rectangle | Rectangle actif en unités de page où le lien est actif |
FileName | Chemin non vide vers le PDF externe ; les barres obliques inverses sont normalisées en barres obliques |
RemoteStructElemID | Chaîne d'octets /ID non vide de l'élément StructElem cible dans FileName ; doit correspondre au /ID apposé sur cet élément via la surcharge IDStr de AddStructureElement |
FallbackTargetPageIndex | Index de page requis commençant à zéro dans le fichier distant, utilisé par la destination de repli /D ; doit être >= 0 |
YPos | Position verticale facultative pour l'ajustement /XYZ ; passez une valeur négative pour la laisser nulle |
NewWindow | Lorsque vrai, émet /NewWindow true afin que le visualiseur ouvre la cible dans une nouvelle fenêtre |
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 - Les cibles de structure distantes ne peuvent pas référencer un StructElem étranger par pointeur, donc ISO 32000-2 §12.3.2.3 exige que le premier élément
/SDsoit la chaîne d'octets/IDde l'élément cible ; la forme de chaîne littérale émise correspond à la forme/IDqueAddStructureElementproduit pour le mêmeIDStr - Émet une action GoToR avec
/F, une destination de repli/Drequise et le tableau de chaînes d'octets/SD - Un
FileNamevide, unRemoteStructElemIDvide ou unFallbackTargetPageIndexnégatif lève une exception avant qu'aucune annotation ni incrément de version ne soit émis