AddFileAttachmentA
Documenteigenschappen
Beschrijving
De afsluitende A geeft het ANSI (char)-DLL-entrypoint aan; het ActiveX/COM-oppervlak biedt alleen de Unicode-vorm. Het gedrag is identiek aan AddFileAttachment en stringargumenten worden geïnterpreteerd volgens de huidige SetAnsiMode-codepagina
Registreert een bestaand ingesloten bestand als bijlage op documentniveau in de PDF-viewer. Readers met een Attachments-paneel tonen de opgegeven titel en openen het gerefereerde ingesloten bestand zodra de gebruiker het selecteert
Roep eerst AddEmbeddedFile aan om de bestandsbytes in het document te kopiëren en de EmbeddedFileID te verkrijgen. AddFileAttachment voegt die filespecificatie daarna toe aan de Catalog /Names /EmbeddedFiles-naamboom, zonder de ingesloten bytes te dupliceren
PDF-versiegedrag: AddEmbeddedFile geeft ingesloten-bestandsstreams en filespecificatie-woordenboeken uit, die PDF 1.3 vereisen. Het registreren van het bestand in de documentniveau /Names /EmbeddedFiles-naamboom vereist PDF 1.4. Is de huidige documentversie lager en is de opslagversie niet vergrendeld, dan verhoogt AddFileAttachment het document automatisch naar PDF 1.4 en registreert /EmbeddedFiles name tree in AutoBumpedFeatures. Vergrendelt de aanroeper een lagere opslagversie, dan weigert de compatibiliteitspoort het opslaan met LastErrorCode 602
Syntaxis
Delphi
Function DLAddFileAttachmentA(InstanceID: Integer; Title: PAnsiChar; EmbeddedFileID: Integer): Integer;
DLL
int DLAddFileAttachmentA(int InstanceID, const char * Title, int EmbeddedFileID);
Syntaxis
| Title | De bijlagenaam die in de viewer wordt getoond en als sleutel in de /EmbeddedFiles-naamboom dient. Hij mag niet leeg zijn |
|---|---|
| EmbeddedFileID | De waarde geretourneerd door AddEmbeddedFile |
Retourwaarden
| 0 | De EmbeddedFileID is ongeldig, de titel is leeg, of er is geen document actief |
|---|---|
| 1 | Het ingesloten bestand is geregistreerd als bijlage op documentniveau |
Opmerkingen
Deze functie maakt een documentniveau-bijlagenlijst-entry aan. Om een klikbaar icoon of hotspot op een pagina te plaatsen, gebruik dan AddLinkToEmbeddedFile. Om een bestand in te bedden én te registreren in één aanroep, gebruik EmbedFile
Zie ook
AddEmbeddedFile, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount