AddPDFA3AssociatedFileFromString

Document properties

Description

یک جریان فایل تعبیه شده را از بایت‌های حافظه ایجاد می‌کند، مشخصات فایل را به درخت نام پیوست سند اضافه می‌کند و آن را در آرایه /AF کاتالوگ برای گردش‌های کاری PDF/A-3 ثبت می‌کند

Syntax

Delphi

Function TPDFlib.AddPDFA3AssociatedFileFromString(Const FileName, MIMEType, Description, Relationship: WideString; Const FileBytes: AnsiString): Integer;

Parameters

FileName	نام فایل نمایش داده شده برای پیوست، مانند `invoice.xml`
MIMEType	نوع MIME نوشته‌شده روی جریان فایل پیوست، مانند `text/xml` یا `application/xml`
Description	متن اختیاری `/Desc` نوشته‌شده در مشخصات فایل
Relationship	مقدار `/AFRelationship`، معمولاً `Source`، `Data`، `Alternative`، `Supplement`، یا `Unspecified`
FileBytes	بایت‌های خام جهت ذخیره در جریان فایل پیوست‌شده

Return values

0	هیچ سند فعالی وجود ندارد، پارامترها نامعتبر هستند، یا سند فعلی در حالت PDF/A-3 نیست
Non-zero	دستگیره شیء برای مشخصات فایل تازه ایجاد شده

Remarks

فایل در لیست پیوست‌های سند قابل مشاهده است و همچنین توسط آرایه کاتالوگ /AF که توسط فایل‌های مرتبط PDF/A-3 نیاز است مورد ارجاع قرار گرفته است

برای فاکتورهای استاندارد Factur-X، ZUGFeRD یا XRechnung XML، استفاده از AddFacturXAssociatedFileFromString ترجیح داده می‌شود تا متادیتای فاکتور و بررسی‌های پروفایل به طور یکنواخت نوشته شوند

Example

// Attach source XML to a PDF/A-3b document
var
  FileID: Integer;
begin
  PDF.SetPDFAMode(5);
  PDF.NewDocument;
  FileID := PDF.AddPDFA3AssociatedFileFromString(
    'invoice.xml',
    'text/xml',
    'Invoice source data',
    'Source',
    InvoiceXML);
  if FileID = 0 then Exit;
  PDF.SaveToFile('archive.pdf');
end;