AddFileAttachment

Dokumentegenskaber

Beskrivelse

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

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