AddFileAttachmentA

Vlastnosti dokumentu

Popis

Koncové A označuje vstupní bod DLL pro ANSI (char); povrch ActiveX/COM vystavuje jen Unicode formu. Chování je shodné s AddFileAttachment a řetězcové argumenty se interpretují podle aktuální kódové stránky SetAnsiMode

Zaregistruje existující vložený soubor jako přílohu na úrovni dokumentu v PDF prohlížeči. Čtečky s panelem Attachments zobrazí zadaný titulek a po výběru uživatelem otevřou odkazovaný vložený soubor

Nejprve zavolejte AddEmbeddedFile, čímž se bajty souboru zkopírují do dokumentu a získá se EmbeddedFileID. AddFileAttachment pak přidá tuto specifikaci souboru do stromu názvů Catalog /Names /EmbeddedFiles, aniž by vložené bajty duplikovala

Chování verzí PDF: AddEmbeddedFile vypíše stream vloženého souboru a slovníky specifikace souboru, které vyžadují PDF 1.3. Registrace souboru ve stromu názvů /Names /EmbeddedFiles na úrovni dokumentu vyžaduje PDF 1.4. Je-li aktuální verze dokumentu nižší a verze ukládání není uzamčena, AddFileAttachment automaticky zvýší dokument na PDF 1.4 a zaznamená strom názvů /EmbeddedFiles do AutoBumpedFeatures. Uzamkne-li volající nižší verzi ukládání, kompatibilita uložení zamítne s LastErrorCode 602

Syntaxe

Delphi

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

DLL

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

Parametry

TitleNázev přílohy zobrazovaný v prohlížeči a používaný jako klíč ve stromu názvů /EmbeddedFiles. Nesmí být prázdný
EmbeddedFileIDHodnota vrácená funkcí AddEmbeddedFile

Návratové hodnoty

0EmbeddedFileID je neplatné, titulek je prázdný, nebo není aktivní žádný dokument
1Vložený soubor se zaregistroval jako příloha na úrovni dokumentu

Poznámky

Tato funkce vytvoří položku seznamu příloh na úrovni dokumentu. Chcete-li na stránku umístit klikatelnou ikonu nebo aktivní oblast, použijte raději AddLinkToEmbeddedFile. Vložit a zaregistrovat soubor jedním voláním lze funkcí EmbedFile

Viz také

AddEmbeddedFile, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount