AddFileAttachmentA
Dokumentegenskaber
Beskrivelse
Det afsluttende A angiver DLL-indgangspunktet for ANSI (char); ActiveX/COM-grænsefladen eksponerer kun Unicode-formen. Funktionsmåden er identisk med AddFileAttachment, og strengargumenter fortolkes med den aktuelle SetAnsiMode-tegntabel
Registrerer en eksisterende integreret fil som en vedhæftet fil på dokumentniveau i PDF-fremviseren. Læsere, der viser panelet Attachments, viser den angivne titel og åbner den refererede integrerede fil, når brugeren vælger den
Kald først AddEmbeddedFile for at kopiere filens byte ind i dokumentet og hente EmbeddedFileID. AddFileAttachment føjer derefter filspecifikationen til Catalog-navnetræet /Names /EmbeddedFiles uden at duplikere de indlejrede byte.
PDF-versionsadfærd: AddEmbeddedFile udsender ordbøger for integrerede filstrømme og filspecifikationer, som kræver PDF 1.3. Registrering af filen i dokumentniveauets /Names /EmbeddedFiles-navnetræ kræver PDF 1.4. Hvis den aktuelle dokumentversion er lavere, og gemmeversionen ikke er låst, hæver AddFileAttachment automatisk dokumentet til PDF 1.4 og registrerer /EmbeddedFiles name tree i AutoBumpedFeatures. Hvis kalderen låser en lavere gemmeversion, afviser kompatibilitetskontrollen lagringen med LastErrorCode 602.
Syntaks
Delphi
Function DLAddFileAttachmentA(InstanceID: Integer; Title: PAnsiChar; EmbeddedFileID: Integer): Integer;DLL
int DLAddFileAttachmentA(int InstanceID, const char * Title, int EmbeddedFileID);Parametre
| Title | Navnet på den vedhæftede fil, som vises i fremviseren og bruges som nøgle i navnetræet /EmbeddedFiles. Det må ikke være tomt. |
|---|---|
| EmbeddedFileID | Værdien returneret af AddEmbeddedFile. |
Returværdier
| 0 | EmbeddedFileID er ugyldigt, titlen er tom, eller intet dokument er aktivt. |
|---|---|
| 1 | Den integrerede fil blev registreret som en vedhæftet fil på dokumentniveau. |
Bemærkninger
Denne funktion opretter en post i en liste over vedhæftede filer på dokumentniveau. Brug i stedet AddLinkToEmbeddedFile for at placere et klikbart ikon eller hotspot på en side. Brug EmbedFile for at indlejre og registrere en fil i ét kald.
Se også
AddEmbeddedFile, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount