SetEmbeddedFileAFRelationship

PDF/UA و دسترس‌پذیری

توضیحات

کلید AFRelationship را در دیکشنری مشخصات فایل برای یک فایل جاسازی‌شده تنظیم می‌کند. طبق ISO 14289-1 (PDF/UA-1) §7.11 وقتی فایل‌های جاسازی‌شده در سند PDF دسترس‌پذیر گنجانده می‌شوند لازم است

نحو

Delphi

Function TPDFlib.SetEmbeddedFileAFRelationship(Index: Integer; Const AFRelationship: WideString): Integer;

ActiveX

Function PDFlib::SetEmbeddedFileAFRelationship(Index As Long, AFRelationship As String) As Long

DLL

int DLSetEmbeddedFileAFRelationship(int InstanceID, int Index, const wchar_t * AFRelationship);

پارامترها

Indexشاخص فایل تعبیه‌شده مبتنی بر صفر؛ بازهٔ معتبر: 0 تا EmbeddedFileCount - 1
AFRelationshipرابطهٔ فایل جاسازی‌شده با سند. باید یکی از مقادیر زیر با حساسیت به بزرگی و کوچکی حروف باشد:

Source — فایل جاسازی‌شده فایل منبعی است که برای ساخت سند استفاده شده
Data — فایل جاسازی‌شده داده‌هایی دارد که سند استفاده می‌کند
Alternative — فایل جاسازی‌شده بازنمایی جایگزین محتوای سند است
Supplement — فایل جاسازی‌شده مکمل سند است
Unspecified — رابطه مشخص نشده است (پیش‌فرض وقتی SetPDFUAMode فعال است)

مقدار بازگشتی

در صورت موفقیت 1 برمی‌گرداند. اگر شاخص خارج از بازه باشد، مقدار AFRelationship یکی از پنج مقدار معتبر نباشد یا سندی باز نباشد 0 برمی‌گرداند

ملاحظات

وقتی SetPDFUAMode فعال باشد، PDF Library for Delphi برای هر فایل تعبیه‌شده‌ای که این کلید را از قبل ندارد خودکار AFRelationship را Unspecified می‌گذارد. برای بازنویسی این پیش‌فرض با مقدار رابطهٔ مشخص‌تر پیش از ذخیره از SetEmbeddedFileAFRelationship استفاده کنید

این تابع را پس از افزودن فایل تعبیه‌شده و پیش از ذخیرهٔ سند فراخوانی کنید

مثال

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

همچنین ببینید

SetPDFUAMode, SetPDFAMode, AddFileAttachment, AddEmbeddedFile, EmbedFile, SetEmbeddedFileStrProperty