AddFileAttachmentA

Właściwości dokumentu

Opis

Końcowa litera A oznacza punkt wejścia DLL ANSI (char); powierzchnia ActiveX/COM udostępnia wyłącznie postać Unicode. Zachowanie jest identyczne jak w AddFileAttachment, a argumenty ciągów są interpretowane przy użyciu bieżącej strony kodowej SetAnsiMode

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 DLAddFileAttachmentA(InstanceID: Integer; Title: PAnsiChar; EmbeddedFileID: Integer): Integer;

DLL

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

Parametry

TitleNazwa załącznika wyświetlana w przeglądarce i używana jako klucz w drzewie nazw /EmbeddedFiles. Nie może być pusta
EmbeddedFileIDWartość zwrócona przez AddEmbeddedFile

Wartości zwracane

0EmbeddedFileID jest nieprawidłowy, tytuł jest pusty albo żaden dokument nie jest aktywny
1Osadzony 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