SetEmbeddedFileAFRelationshipA

PDF/UA وإمكانية الوصول

الوصف

الحرف المُلحق A يُشير إلى نقطة دخول ANSI (char) في DLL؛ بينما تكشف واجهة ActiveX/COM الشكل Unicode فقط. السلوك مطابق لـ SetEmbeddedFileAFRelationship وتُفسَّر وسائط السلاسل النصية باستخدام صفحة الرموز الحالية لـ SetAnsiMode

يضبط مفتاح AFRelationship في قاموس مواصفة الملف لملف مضمّن. مطلوب وفق ISO 14289-1‏ (PDF/UA-1) §7.11 عند تضمين ملفات مضمّنة في مستند PDF يسهل الوصول إليه

الصيغة

Delphi

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

DLL

int DLSetEmbeddedFileAFRelationshipA(int InstanceID, int Index, const char * 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