AddFileAttachment

Documenteigenschappen

Beschrijving

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 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);

Parameters

TitleDe bijlagenaam die in de viewer wordt getoond en als sleutel in de /EmbeddedFiles-naamboom dient. Hij mag niet leeg zijn
EmbeddedFileIDDe waarde geretourneerd door AddEmbeddedFile

Retourwaarden

0De EmbeddedFileID is ongeldig, de titel is leeg, of er is geen document actief
1Het 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