AddFileAttachment
문서 속성
설명
기존 포함 파일을 PDF 뷰어의 문서 수준 첨부 파일로 등록합니다. Attachments 패널을 제공하는 리더는 지정한 제목을 표시하고 사용자가 선택하면 참조된 포함 파일을 엽니다
먼저 AddEmbeddedFile을 호출하여 파일 바이트를 문서에 복사하고 EmbeddedFileID를 얻습니다. 그런 다음 AddFileAttachment가 임베디드 바이트를 중복하지 않고 해당 파일 사양을 Catalog /Names /EmbeddedFiles 이름 트리에 추가합니다
PDF 버전 동작: AddEmbeddedFile은 PDF 1.3이 필요한 포함 파일 스트림과 파일 사양 사전을 출력합니다. 문서 수준 /Names /EmbeddedFiles 이름 트리에 파일을 등록하려면 PDF 1.4가 필요합니다. 현재 문서 버전이 더 낮고 저장 버전이 잠기지 않았으면 AddFileAttachment는 문서를 PDF 1.4로 자동 승격하고 /EmbeddedFiles name tree를 AutoBumpedFeatures에 기록합니다. 호출자가 더 낮은 저장 버전을 잠그면 호환성 게이트가 LastErrorCode 602로 저장을 거부합니다
구문
Delphi
Function TPDFlib.AddFileAttachment(Const Title: WideString; EmbeddedFileID: Integer): Integer;ActiveX
Function PDFlib::AddFileAttachment(Title As String, EmbeddedFileID As Long) As LongDLL
int DLAddFileAttachment(int InstanceID, const wchar_t * Title, int EmbeddedFileID);매개변수
| Title | 뷰어에 표시되고 /EmbeddedFiles 이름 트리의 키로 사용되는 첨부 파일 이름이며 비워 둘 수 없습니다 |
|---|---|
| EmbeddedFileID | AddEmbeddedFile이 반환한 값 |
반환 값
| 0 | EmbeddedFileID가 유효하지 않거나 제목이 비어 있거나 활성 문서가 없습니다 |
|---|---|
| 1 | 포함 파일이 문서 수준 첨부 파일로 등록되었습니다 |
비고
이 함수는 문서 수준 첨부 파일 목록 항목을 만듭니다. 페이지에 클릭 가능한 아이콘이나 핫스폿을 배치하려면 대신 AddLinkToEmbeddedFile을 사용하십시오. 한 번의 호출로 파일을 임베드하고 등록하려면 EmbedFile을 사용하십시오
참고 항목
AddEmbeddedFile, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount