SetEmbeddedFileAFRelationship

PDF/UA & Erişilebilirlik

Açıklama

Gömülü bir dosyanın dosya belirtimi sözlüğünde AFRelationship anahtarını ayarlar. Gömülü dosyalar erişilebilir bir PDF belgesine eklendiğinde ISO 14289-1 (PDF/UA-1) §7.11 tarafından zorunlu tutulur

Sözdizimi

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

Parametreler

Index	Gömülü dosyanın 1 tabanlı dizini. Geçerli aralık: 1 ile EmbeddedFileCount
AFRelationship	Gömülü dosyanın belgeyle ilişkisi. Aşağıdaki büyük-küçük harfe duyarlı değerlerden biri olmalıdır: Source — gömülü dosya, belgeyi oluşturmak için kullanılan kaynak dosyadır Data — gömülü dosya, belgenin kullandığı verileri içerir Alternative — gömülü dosya, belge içeriğinin alternatif bir gösterimidir Supplement — gömülü dosya, belgeyi tamamlayıcı niteliktedir Unspecified — ilişki belirtilmemiştir (SetPDFUAMode etkinken varsayılan)

Index

Gömülü dosyanın 1 tabanlı dizini. Geçerli aralık: 1 ile EmbeddedFileCount

AFRelationship

Gömülü dosyanın belgeyle ilişkisi. Aşağıdaki büyük-küçük harfe duyarlı değerlerden biri olmalıdır:

Source — gömülü dosya, belgeyi oluşturmak için kullanılan kaynak dosyadır
Data — gömülü dosya, belgenin kullandığı verileri içerir
Alternative — gömülü dosya, belge içeriğinin alternatif bir gösterimidir
Supplement — gömülü dosya, belgeyi tamamlayıcı niteliktedir
Unspecified — ilişki belirtilmemiştir (SetPDFUAMode etkinken varsayılan)

Dönüş değeri

Başarı durumunda 1 döndürür. Dizin aralık dışındaysa, AFRelationship değeri beş geçerli değerden biri değilse veya açık belge yoksa 0 döndürür

Açıklamalar

SetPDFUAMode etkinken PDF Library for Delphi, anahtara henüz sahip olmayan tüm gömülü dosyalarda AFRelationship değerini otomatik olarak Unspecified yapar. Bu varsayılanı daha özel bir ilişki değeriyle geçersiz kılmak için kaydetmeden önce SetEmbeddedFileAFRelationship kullanın

Bu işlevi gömülü dosyayı ekledikten sonra ve belgeyi kaydetmeden önce çağırın

Örnek

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

Ayrıca bkz

SetPDFUAMode, SetPDFAMode, AddFileAttachment, AddEmbeddedFile, EmbedFile, SetEmbeddedFileStrProperty