AddFileAttachment

Vlastnosti dokumentu

Popis

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

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