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