AddEmbeddedFileA

Thuộc tính tài liệu

Mô tả

Ký tự A ở cuối biểu thị điểm vào DLL ANSI (char); bề mặt ActiveX/COM chỉ cung cấp dạng Unicode. Hành vi giống hệt với AddEmbeddedFile và các đối số chuỗi được diễn giải theo trang mã SetAnsiMode hiện tại

Nhúng một file vào PDF dưới dạng embedded file stream nhưng bản thân nó không đăng ký file vào bất kỳ danh sách catalog nào hay vẽ chú thích bấm được. Hàm trả về một handle EmbeddedFileID truyền được cho AddFileAttachment (để gắn icon kẹp giấy lên trang) hoặc AddLinkToEmbeddedFile (để tạo hotspot bấm được mở file). Muốn vừa nhúng file vừa liệt kê nó thành attachment cấp tài liệu trong một lần gọi, hãy dùng EmbedFile

Cú pháp

Delphi

Function DLAddEmbeddedFileA(InstanceID: Integer; FileName, MIMEType: PAnsiChar): Integer;

DLL

int DLAddEmbeddedFileA(int InstanceID, const char * FileName, const char * MIMEType);

Tham số

FileName	Đường dẫn và tên đầy đủ của file nguồn trên đĩa. Các byte của nó được copy nguyên vẹn vào một stream file nhúng của PDF
MIMEType	MIME type của file, ví dụ `image/jpeg` hoặc `application/xml`. Có thể là chuỗi rỗng khi MIME type không rõ

Giá trị trả về

0	Không mở được file hoặc không có tài liệu nào đang hoạt động
Non-zero	Một handle EmbeddedFileID dùng với AddFileAttachment, AddLinkToEmbeddedFile hay SetEmbeddedFileStrProperty

Ghi chú

Hành vi phiên bản PDF: embedded file stream và các dictionary file specification đòi PDF 1.3. Nếu phiên bản tài liệu hiện tại thấp hơn và phiên bản lưu chưa bị khóa, AddEmbeddedFile tự nâng tài liệu lên PDF 1.3. Các lời gọi đăng ký file thành attachment cấp tài liệu có thể đòi phiên bản cao hơn: AddFileAttachment và EmbedFile dùng name tree /Names /EmbeddedFiles của PDF 1.4, còn AddLinkToEmbeddedFile dùng độ mờ chú thích/transparency appearance của PDF 1.4

File chỉ nhúng bằng AddEmbeddedFile là một phần của PDF nhưng UI của reader không thấy cho đến khi nó được đăng ký vào danh sách attachment của tài liệu hoặc được một chú thích trang tham chiếu. Tái dùng cùng EmbeddedFileID với AddFileAttachment và AddLinkToEmbeddedFile giúp bạn phơi một file nhúng qua cả UI cấp tài liệu lẫn cấp trang mà không phải nhân bản byte nhúng

PDF/A compatibility:

PDF/A-1, PDF/A-2 (SetPDFAMode modes 1–4) — embedded files are forbidden; the call is rejected.
PDF/A-3 (SetPDFAMode modes 5, 6, and 7) — embedded files of any MIME type are permitted. Set the file's relationship via SetEmbeddedFileAFRelationship before saving.

Ví dụ

// Expose the same embedded file through the document attachment list and a page annotation
var
  FileID: Integer;
begin
  PDF.NewDocument;
  PDF.AddStandardFont('Helvetica');

  FileID := PDF.AddEmbeddedFile('C:\reports\sales.csv', 'text/csv');
  if FileID = 0 then Exit;

  PDF.AddFileAttachment('Source data', FileID);

  PDF.AddPage;
  PDF.PrintText(50, 750, 'See attached source data');
  PDF.AddLinkToEmbeddedFile(50, 720, 16, 16, FileID, 'Source data', 'Open source CSV', 4, 0);

  PDF.SaveToFile('with-attachment.pdf');
end;

Xem thêm

AddFileAttachment, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, SetEmbeddedFileStrProperty, EmbeddedFileCount