AddFileAttachment

Właściwości dokumentu

Opis

Rejestruje istniejący osadzony plik jako załącznik na poziomie dokumentu w przeglądarce PDF. Czytniki udostępniające panel załączników pokazują podany tytuł i otwierają wskazany osadzony plik po wybraniu go przez użytkownika

Najpierw wywołaj AddEmbeddedFile, aby skopiować bajty pliku do dokumentu i uzyskać EmbeddedFileID. Następnie AddFileAttachment dodaje tę specyfikację pliku do drzewa nazw katalogu /Names /EmbeddedFiles bez powielania osadzonych bajtów

Zachowanie wersji PDF: AddEmbeddedFile emituje strumień osadzonego pliku i słowniki specyfikacji pliku, które wymagają PDF 1.3. Zarejestrowanie pliku w drzewie nazw /Names /EmbeddedFiles na poziomie dokumentu wymaga PDF 1.4. Jeśli bieżąca wersja dokumentu jest niższa, a wersja zapisu nie jest zablokowana, AddFileAttachment automatycznie podnosi dokument do PDF 1.4 i zapisuje /EmbeddedFiles name tree w AutoBumpedFeatures. Jeśli kod wywołujący zablokuje niższą wersję zapisu, kontrola zgodności odrzuci zapis z LastErrorCode 602

Składnia

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	Nazwa załącznika wyświetlana w przeglądarce i używana jako klucz w drzewie nazw `/EmbeddedFiles`. Nie może być pusta
EmbeddedFileID	Wartość zwrócona przez AddEmbeddedFile

Wartości zwracane

0	EmbeddedFileID jest nieprawidłowy, tytuł jest pusty albo żaden dokument nie jest aktywny
1	Osadzony plik został zarejestrowany jako załącznik na poziomie dokumentu

Uwagi

Ta funkcja tworzy wpis listy załączników na poziomie dokumentu. Aby umieścić na stronie klikalną ikonę lub aktywny obszar, użyj zamiast niej AddLinkToEmbeddedFile. Aby osadzić i zarejestrować plik jednym wywołaniem, użyj EmbedFile

Zobacz również

AddEmbeddedFile, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount