AddFileAttachment

Propriétés du document

Description

Enregistre un fichier incorporé existant comme pièce jointe au niveau du document dans le visualiseur PDF. Les lecteurs qui affichent le panneau des pièces jointes présentent le titre fourni et ouvrent le fichier incorporé référencé lorsque l’utilisateur le sélectionne

Appelez d’abord AddEmbeddedFile pour copier les octets du fichier dans le document et obtenir EmbeddedFileID. AddFileAttachment ajoute ensuite cette spécification à l’arbre de noms /Names /EmbeddedFiles du catalogue sans dupliquer les octets incorporés

Comportement selon la version PDF : AddEmbeddedFile émet les dictionnaires de flux de fichier incorporé et de spécification de fichier, qui exigent PDF 1.3. L’inscription dans l’arbre de noms /Names /EmbeddedFiles du document exige PDF 1.4. Si la version courante est inférieure et que la version d’enregistrement n’est pas verrouillée, AddFileAttachment élève automatiquement le document à PDF 1.4 et consigne /EmbeddedFiles name tree 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.AddFileAttachment(Const Title: WideString; EmbeddedFileID: Integer): Integer;

ActiveX

Function PDFlib::AddFileAttachment(Title As String, EmbeddedFileID As Long) As Long

DLL

int DLAddFileAttachment(int InstanceID, const wchar_t * Title, int EmbeddedFileID);

Paramètres

Title	Nom de la pièce jointe affiché dans le lecteur et utilisé comme clé dans l'arborescence de noms `/EmbeddedFiles`. Il ne doit pas être vide
EmbeddedFileID	Valeur renvoyée par AddEmbeddedFile

Valeurs de retour

0	L'EmbeddedFileID n'est pas valide, le titre est vide ou aucun document n'est actif
1	Le fichier incorporé a été enregistré comme pièce jointe au niveau du document

Remarques

Cette fonction crée une entrée de liste de pièces jointes au niveau du document. Pour placer une icône ou zone cliquable sur une page, utilisez plutôt AddLinkToEmbeddedFile. Pour incorporer et enregistrer un fichier en un appel, utilisez EmbedFile

Voir aussi

AddEmbeddedFile, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount