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 نشطًا)

Index

فهرس الملف المضمّن ويبدأ العد من صفر. النطاق الصالح: من 0 إلى EmbeddedFileCount - 1

AFRelationship

علاقة الملف المضمّن بالمستند. يجب أن تكون إحدى القيم التالية (حساسة لحالة الأحرف):

Source — الملف المضمّن هو ملف المصدر المستخدم لإنشاء المستند
Data — يحتوي الملف المضمّن على بيانات يستخدمها المستند
Alternative — الملف المضمّن تمثيل بديل لمحتوى المستند
Supplement — الملف المضمّن مكمّل للمستند
Unspecified — العلاقة غير محددة (الافتراضي عندما يكون SetPDFUAMode نشطًا)

قيمة الإرجاع

تُرجع 1 عند النجاح. وتُرجع 0 إذا كان الفهرس خارج النطاق أو لم تكن قيمة AFRelationship إحدى القيم الخمس الصالحة أو لم يكن هناك مستند مفتوح

ملاحظات

عندما يكون SetPDFUAMode نشطًا تضبط PDF Library for Delphi‏ AFRelationship على Unspecified تلقائيًا لأي ملف مضمّن لا يملك المفتاح سلفًا. استخدم SetEmbeddedFileAFRelationship قبل الحفظ لتجاوز هذا الافتراضي بقيمة علاقة أكثر تحديدًا

استدعِ هذه الدالة بعد BeginTag بنوع وسم L (قائمة) وقبل EndTag. وتُعرَّف خاصية /ListNumbering في ISO 32000-1 §14.8.5.3.2 (مالك خصائص القوائم، الجدول 336)

مثال

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