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
| Title | Der im Viewer angezeigte Name des Anhangs, der zugleich als Schlüssel im Namensbaum /EmbeddedFiles verwendet wird. Er darf nicht leer sein. |
|---|---|
| EmbeddedFileID | Der von AddEmbeddedFile zurückgegebene Wert. |
Rückgabewerte
| 0 | Die EmbeddedFileID ist ungültig, der Titel ist leer oder es ist kein Dokument aktiv. |
|---|---|
| 1 | Die 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