AddFileAttachmentA
Propriétés du document
Description
Le A final indique le point d’entrée de DLL ANSI (char); l’interface ActiveX/COM n’expose que la forme Unicode. Le comportement est identique à AddFileAttachment et les arguments de chaîne sont interprétés selon la page de codes SetAnsiMode actuelle
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 DLAddFileAttachmentA(InstanceID: Integer; Title: PAnsiChar; EmbeddedFileID: Integer): Integer;DLL
int DLAddFileAttachmentA(int InstanceID, const char * 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