AddLinkToEmbeddedPDFA
Annotations et liens de zone réactive
Description
Le suffixe A désigne le point d'entrée ANSI (char) de la DLL ; la surface ActiveX/COM n'expose que la variante Unicode. Le comportement est identique à AddLinkToEmbeddedPDF et les arguments de chaîne sont interprétés à l'aide de la page de codes SetAnsiMode courante
Ajoute à la page sélectionnée un lien qui ouvre un PDF incorporé dans le fichier actuel et atteint une page. Le lien porte une action /GoToE selon ISO 32000-1 §12.6.4.4 ; sa chaîne cible désigne le fichier incorporé dans l'arbre EmbeddedFiles du document, et la destination ajuste la page cible à la fenêtre
Comme /GoToE a été introduit avec PDF 1.6, cet appel relève au besoin la version du document à 1.6. GetAnnotActionInfo permet de relire ces actions : il indique le type akGoToE, le nom de cible incorporée, la relation parent-enfant et l’indicateur /NewWindow
Syntaxe
Delphi
Function DLAddLinkToEmbeddedPDFA(InstanceID: Integer; Left, Top, Width, Height: Double; EmbeddedFileName: PAnsiChar; TargetPage, NewWindow, Options: Integer): Integer;DLL
int DLAddLinkToEmbeddedPDFA(int InstanceID, double Left, double Top, double Width, double Height, const char * EmbeddedFileName, int TargetPage, int NewWindow, int Options);Paramètres
| Left, Top, Width, Height | Position et taille de la zone active sur la page sélectionnée |
|---|---|
| EmbeddedFileName | Nom du fichier incorporé dans l'arborescence EmbeddedFiles d'un document, tel que transmis à EmbedFile, par exemple "report.pdf" |
| TargetPage | Page basée sur 1 du document incorporé vers laquelle accéder |
| NewWindow | 1 = demander au visualiseur d'ouvrir le document incorporé dans une nouvelle fenêtre, 0 = valeur par défaut du visualiseur |
| Options | 1 = tracer une bordure autour de la zone active, 0 = aucune bordure |
Valeurs de retour
| 0 | Le lien n’a pas pu être ajouté (nom vide ou page non valide) |
|---|---|
| 1 | Success |