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
| Title | Název přílohy zobrazovaný v prohlížeči a používaný jako klíč ve stromu názvů /EmbeddedFiles. Nesmí být prázdný |
|---|---|
| EmbeddedFileID | Hodnota vrácená funkcí AddEmbeddedFile |
Návratové hodnoty
| 0 | EmbeddedFileID je neplatné, titulek je prázdný, nebo není aktivní žádný dokument |
|---|---|
| 1 | Vlož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