AddLinkToEmbeddedFile

Propriétés du document, annotations et liens de zone réactive

Description

Ajoute à la page sélectionnée un rectangle d'annotation FileAttachment et le lie à un fichier incorporé déjà enregistré dans le document

Appelez d’abord AddEmbeddedFile pour copier les octets dans le PDF et obtenir EmbeddedFileID. AddLinkToEmbeddedFile crée l’annotation de page, écrit le titre de la pièce jointe et le contenu contextuel, puis la dirige vers cette spécification de fichier incorporé

Comportement selon la version PDF : les annotations FileAttachment et les flux de fichiers incorporés exigent PDF 1.3. L’apparence d’annotation générée peut inclure l’opacité via /CA et des ressources de transparence, qui exigent PDF 1.4. Si la version courante est inférieure et que la version d’enregistrement n’est pas verrouillée, AddLinkToEmbeddedFile élève automatiquement le document à PDF 1.4 et consigne /CA annotation opacity dans AutoBumpedFeatures. Si l’appelant verrouille une version inférieure, le contrôle de compatibilité refuse l’enregistrement avec LastErrorCode 602

Syntaxe

Delphi

Function TPDFlib.AddLinkToEmbeddedFile(Left, Top, Width, Height: Double; EmbeddedFileID: Integer; Const Title, Contents: WideString; IconType, Transparency: Integer): Integer;

ActiveX

Function PDFlib::AddLinkToEmbeddedFile(Left As Double, Top As Double, Width As Double, Height As Double, EmbeddedFileID As Long, Title As String, Contents As String, IconType As Long, transpareny As Long) As Long

DLL

int DLAddLinkToEmbeddedFile(int InstanceID, double Left, double Top, double Width, double Height, int EmbeddedFileID, const wchar_t * Title, const wchar_t * Contents, int IconType, int transpareny);

Paramètres

Left	Coordonnée horizontale du bord gauche du rectangle de l’annotation
Top	Coordonnée verticale du bord supérieur du rectangle de l’annotation
Width	Largeur du rectangle de l’annotation
Height	Hauteur du rectangle de l’annotation
EmbeddedFileID	Valeur renvoyée par AddEmbeddedFile
Title	Titre de la pièce jointe affiché par le lecteur PDF
Contents	Texte affiché dans la fenêtre contextuelle de l’annotation
IconType	Icône de l'annotation : 0 = Punaise, 1 = image de disque, 2 = aucune icône, 3 = graphique, 4 = trombone, 5 = étiquette, 6 = rectangle blanc uni
Transparency	Le pourcentage de transparence de 0 à 100 Zéro est entièrement opaque ; 100 rend l'icône invisible

Valeurs de retour

0	L'EmbeddedFileID n'est pas valide, aucune page n'est sélectionnée ou aucun document n'est actif
1	L’annotation FileAttachment a été créée

Voir aussi

AddEmbeddedFile, AddFileAttachment, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount