เอกสารอ้างอิงสำหรับนักพัฒนา PDFium Delphi Component

Component: TPdf · Unit: PDFium

บันทึก PDF ที่เปิดใช้งานอยู่ไปยังพาธไฟล์ในขณะที่แทรกไฟล์ที่เกี่ยวข้อง (associated files) ลงในแค็ตตาล็อกหรือหน้าตามข้อกำหนด ISO 32000-2 §7.11.4

Syntax

function SaveAsWithAssociateFiles(const FileName: string; const Options: TAssocFilesOptions): Boolean;

FileName	string. The target output file path
Options	TAssocFilesOptions. Injection options detailing files, metadata, and the target catalog or page attachment point

Return Value

คืนค่า True หากบันทึก PDF ที่แทรกไฟล์ที่เกี่ยวข้องสำเร็จ หรือ False เมื่อล้มเหลว

Description

SaveAsWithAssociateFiles ใช้การแทรก Associate Files ของ PDF 2.0 (ISO 32000-2 §7.11.4)

เมธอดนี้ใช้เพื่อแนบไฟล์ (เช่น ข้อมูล XML, source schemas, เทมเพลต) เข้ากับแค็ตตาล็อกเอกสารหรือหน้าแต่ละหน้าโดยตรง พร้อมด้วยเมทาดาทา /AFRelationship ที่ระบุอย่างชัดเจน

TAssociateFile.Description เขียนค่า /Desc แบบอ่านง่ายของ file specification ซึ่งใช้ในเวิร์กโฟลว์ด้านการเข้าถึง (accessibility) และการค้นพบไฟล์

Remarks

การแทรกออบเจกต์ filespec ข้อความธรรมดาลงในเอกสารที่เข้ารหัสจะทำให้เอกสารเสียหาย ดังนั้นเมธอดนี้จึงลบตัวเลือกความปลอดภัยที่มีอยู่โดยอัตโนมัติในระหว่างการทำซีเรียไลซ์ (เทียบเท่ากับการใช้ saRemoveSecurity)
ไฟล์ต่างๆ จะถูกส่งผ่านโครงสร้าง TAssocFilesOptions โดยระบุชื่อไฟล์, อาร์เรย์ของเนื้อหา, MIME types และความสัมพันธ์

Example

var
  Opts: TAssocFilesOptions;
  F: TAssociateFile;
begin
  Opts := TAssocFilesOptions.Default;
  Opts.TargetPage := 0; // catalog-level attachment

  F.FileName := 'data.xml';
  F.Description := 'Source data for this document';
  F.Content := GetXmlBytes;
  F.Relationship := afData;
  F.MIMEType := 'text/xml';

  SetLength(Opts.Files, 1);
  Opts.Files[0] := F;

  if Pdf1.SaveAsWithAssociateFiles('output.pdf', Opts) then
    ShowMessage('PDF with associate files saved successfully');
end;

เมธอด SaveAsWithAssociateFiles