SetEmbeddedFileAFRelationshipA

PDF/UA và khả năng truy cập

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 SetEmbeddedFileAFRelationship và các đối số chuỗi được diễn giải theo trang mã SetAnsiMode hiện tại

Đặt khóa AFRelationship trong từ điển đặc tả tệp của một tệp nhúng. Bắt buộc theo ISO 14289-1 (PDF/UA-1) §7.11 khi có tệp nhúng trong tài liệu PDF có thể truy cập.

Cú pháp

Delphi

Function DLSetEmbeddedFileAFRelationshipA(InstanceID, Index: Integer; AFRelationship: PAnsiChar): Integer;

DLL

int DLSetEmbeddedFileAFRelationshipA(int InstanceID, int Index, const char * AFRelationship);

Tham số

Index	Chỉ số file nhúng (bắt đầu từ 0). Khoảng hợp lệ: 0 đến EmbeddedFileCount - 1
AFRelationship	Quan hệ của tệp nhúng với tài liệu. Phải là một trong các giá trị phân biệt chữ hoa chữ thường sau: Source – tệp nhúng là tệp nguồn dùng để tạo tài liệu Data – tệp nhúng chứa dữ liệu mà tài liệu sử dụng Alternative – tệp nhúng là bản trình bày thay thế của nội dung tài liệu Supplement – tệp nhúng là phần bổ sung cho tài liệu Unspecified – không chỉ định quan hệ (mặc định khi SetPDFUAMode đang bật)

Index

Chỉ số file nhúng (bắt đầu từ 0). Khoảng hợp lệ: 0 đến EmbeddedFileCount - 1

AFRelationship

Quan hệ của tệp nhúng với tài liệu. Phải là một trong các giá trị phân biệt chữ hoa chữ thường sau:

Source – tệp nhúng là tệp nguồn dùng để tạo tài liệu
Data – tệp nhúng chứa dữ liệu mà tài liệu sử dụng
Alternative – tệp nhúng là bản trình bày thay thế của nội dung tài liệu
Supplement – tệp nhúng là phần bổ sung cho tài liệu
Unspecified – không chỉ định quan hệ (mặc định khi SetPDFUAMode đang bật)

Giá trị trả về

Trả về 1 khi thành công. Trả về 0 nếu chỉ số ngoài khoảng hợp lệ, giá trị AFRelationship không thuộc năm giá trị hợp lệ, hoặc không có tài liệu nào đang mở

Ghi chú

Khi SetPDFUAMode đang hoạt động, PDF Library for Delphi tự đặt AFRelationship thành Unspecified cho mọi file nhúng chưa có key này. Dùng SetEmbeddedFileAFRelationship trước khi lưu để ghi đè mặc định này bằng một giá trị relationship cụ thể hơn

Gọi hàm này sau khi thêm file nhúng và trước khi lưu tài liệu

Ví dụ

// PDF/A-3 archive that embeds an XLSX as the document's source data
var
  FileID: Integer;
begin
  PDF.SetPDFAMode(5);              // PDF/A-3b — allows arbitrary embedded files
  PDF.NewDocument;
  PDF.AddStandardFont('Helvetica');
  PDF.AddPage;
  PDF.PrintText(50, 750, 'Quarterly Sales Report');

  FileID := PDF.AddEmbeddedFile(
    'sales-Q1.xlsx',
    'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
  PDF.AddFileAttachment('Source spreadsheet', FileID);

  // Mark the relationship: the spreadsheet is the source of the report
  PDF.SetEmbeddedFileAFRelationship(1, 'Source');

  PDF.SaveToFile('report-PDFA3b.pdf');
end;

Xem thêm

SetPDFUAMode, SetPDFAMode, AddFileAttachment, AddEmbeddedFile, EmbedFile, SetEmbeddedFileStrProperty