AddFileAttachmentA

Dokumenteigenschaften

Beschreibung

Das abschließende A kennzeichnet den ANSI-Einstiegspunkt (char) der DLL; die ActiveX/COM-Oberfläche stellt nur die Unicode-Form bereit. Das Verhalten entspricht AddFileAttachment, und Zeichenfolgenargumente werden anhand der aktuellen Codepage von SetAnsiMode interpretiert

Prüfen Sie Syntax, Parameter und Rückgabewerte, bevor Sie die Funktion aufrufen Die Codeblöcke bleiben im Original erhalten, damit Beispiele unverändert übernommen werden können.

Rufen Sie zunächst AddEmbeddedFile auf, um die Dateibytes in das Dokument zu kopieren und die EmbeddedFileID zu erhalten. AddFileAttachment fügt diese Dateispezifikation anschließend dem Namensbaum /Names /EmbeddedFiles des Katalogs hinzu, ohne die eingebetteten Bytes zu duplizieren.

Verhalten der PDF-Version: AddEmbeddedFile gibt den eingebetteten Dateistream und die Dateispezifikationswörterbücher aus, wofür PDF 1.3 erforderlich ist. Für die Registrierung der Datei im dokumentweiten Namensbaum /Names /EmbeddedFiles ist PDF 1.4 erforderlich. Ist die aktuelle Dokumentversion niedriger und die Speicherversion nicht gesperrt, hebt AddFileAttachment das Dokument automatisch auf PDF 1.4 an und trägt /EmbeddedFiles name tree in AutoBumpedFeatures ein. Sperrt der Aufrufer eine niedrigere Speicherversion, lehnt die Kompatibilitätsprüfung das Speichern mit LastErrorCode 602 ab.

Syntax

Delphi

Function DLAddFileAttachmentA(InstanceID: Integer; Title: PAnsiChar; EmbeddedFileID: Integer): Integer;

DLL

int DLAddFileAttachmentA(int InstanceID, const char * Title, int EmbeddedFileID);

Parameter

TitleDer im Viewer angezeigte Name des Anhangs, der zugleich als Schlüssel im Namensbaum /EmbeddedFiles verwendet wird. Er darf nicht leer sein.
EmbeddedFileIDDer von AddEmbeddedFile zurückgegebene Wert.

Rückgabewerte

0Die EmbeddedFileID ist ungültig, der Titel ist leer oder es ist kein Dokument aktiv.
1Die eingebettete Datei wurde als Anhang auf Dokumentebene registriert.

Hinweise

Prüfen Sie Syntax, Parameter und Rückgabewerte, bevor Sie die Funktion aufrufen Die Codeblöcke bleiben im Original erhalten, damit Beispiele unverändert übernommen werden können. AddLinkToEmbeddedFile, EmbedFile

Siehe auch

AddEmbeddedFile, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount