SetEmbeddedFileAFRelationship

PDF/UA & Accessibility

Description

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

Syntax

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

Parameters

Index	فهرس الملف المضمن المستند إلى الصفر؛ النطاق الصالح: من 0 إلى EmbeddedFileCount - 1
AFRelationship	علاقة الملف المضمن بالمستند؛ ويجب أن تكون واحدة من القيم التالية الحساسة لحالة الأحرف: Source — الملف المضمن هو الملف المصدر المستخدم لإنشاء المستند Data — يحتوي الملف المضمن على بيانات مستخدمة بواسطة المستند Alternative — الملف المضمن هو تمثيل بديل لمحتوى المستند Supplement — الملف المضمن مكمل للمستند Unspecified — لم يتم تحديد العلاقة (الافتراضي عندما يكون SetPDFUAMode نشطا)

Index

فهرس الملف المضمن المستند إلى الصفر؛ النطاق الصالح: من 0 إلى EmbeddedFileCount - 1

AFRelationship

علاقة الملف المضمن بالمستند؛ ويجب أن تكون واحدة من القيم التالية الحساسة لحالة الأحرف:

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

Return value

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

Remarks

عندما يكون وضع SetPDFUAMode نشطًا، تعين PDFlibPas تلقائيًا AFRelationship إلى Unspecified لأي ملف مضمن لا يحتوي بالفعل على المفتاح؛ واستخدم SetEmbeddedFileAFRelationship قبل الحفظ لتجاوز هذا الافتراضي بقيمة علاقة أكثر تحديدًا

استدع هذه الوظيفة بعد إضافة الملف المضمن وقبل حفظ المستند

Example

// 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(0, 'Source');

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