AddEmbeddedFile

Belge özellikleri

Açıklama

Bir dosyayı PDF içine gömülü dosya akışı olarak gömer ancak tek başına dosyayı herhangi bir katalog listesine kaydetmez veya tıklanabilir açıklama çizmez. İşlev bir EmbeddedFileID tanıtıcısı döndürür; bu tanıtıcı AddFileAttachment (sayfaya ataş simgesi eklemek için) veya AddLinkToEmbeddedFile (dosyayı açan tıklanabilir etkin nokta oluşturmak için) işlevine geçirilebilir. Bir dosyayı tek çağrıda hem gömmek hem de belge düzeyinde ek olarak listelemek için bunun yerine EmbedFile kullanın

Sözdizimi

Delphi

Function TPDFlib.AddEmbeddedFile(Const FileName, MIMEType: WideString): Integer;

ActiveX

Function PDFlib::AddEmbeddedFile(FileName As String, MIMEType As String) As Long

DLL

int DLAddEmbeddedFile(int InstanceID, const wchar_t * FileName, const wchar_t * MIMEType);

Parametreler

FileName	Diskteki kaynak dosyanın tam yolu ve adı. Baytları olduğu gibi bir PDF gömülü dosya akışına kopyalanır
MIMEType	Dosyanın MIME türü; örneğin `image/jpeg` veya `application/xml`. MIME türü bilinmiyorsa boş bir dize olabilir

Dönüş değerleri

0	Dosya açılamadı veya etkin belge yok
Non-zero	EmbeddedFileID tanıtıcısı; AddFileAttachment, AddLinkToEmbeddedFile veya SetEmbeddedFileStrProperty ile kullanılır

Açıklamalar

PDF sürümü davranışı: gömülü dosya akışları ve dosya belirtimi sözlükleri PDF 1.3 gerektirir. Geçerli belge sürümü daha düşükse ve kaydetme sürümü kilitli değilse AddEmbeddedFile belgeyi otomatik olarak PDF 1.3 sürümüne yükseltir. Dosyayı belge düzeyinde ek olarak kaydeden çağrılar daha yüksek sürüm gerektirebilir: AddFileAttachment ve EmbedFile PDF 1.4 /Names /EmbeddedFiles ad ağacını, AddLinkToEmbeddedFile ise PDF 1.4 ek açıklama opaklığı/görünüm saydamlığını kullanır

Yalnızca AddEmbeddedFile ile gömülen bir dosya PDF'nin parçasıdır ancak belge ekleri listesine kaydedilene veya bir sayfa ek açıklaması tarafından başvurulana kadar okuyucu kullanıcı arayüzünde görünmez. Aynı EmbeddedFileID değerini AddFileAttachment ve AddLinkToEmbeddedFile ile yeniden kullanmak, gömülü baytları yinelemeden tek bir gömülü dosyayı hem belge hem de sayfa düzeyi kullanıcı arayüzünde göstermenizi sağlar

PDF/A uyumluluğu:

PDF/A-1, PDF/A-2 (SetPDFAMode modları 1–4) — gömülü dosyalar yasaktır; çağrı reddedilir
PDF/A-3 (SetPDFAMode modları 5, 6 ve 7) — tüm MIME türlerindeki gömülü dosyalara izin verilir. Kaydetmeden önce dosyanın ilişkisini SetEmbeddedFileAFRelationship ile ayarlayın

Örnek

// Expose the same embedded file through the document attachment list and a page annotation
var
  FileID: Integer;
begin
  PDF.NewDocument;
  PDF.AddStandardFont('Helvetica');

  FileID := PDF.AddEmbeddedFile('C:\reports\sales.csv', 'text/csv');
  if FileID = 0 then Exit;

  PDF.AddFileAttachment('Source data', FileID);

  PDF.AddPage;
  PDF.PrintText(50, 750, 'See attached source data');
  PDF.AddLinkToEmbeddedFile(50, 720, 16, 16, FileID, 'Source data', 'Open source CSV', 4, 0);

  PDF.SaveToFile('with-attachment.pdf');
end;

Ayrıca bkz

AddFileAttachment, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, SetEmbeddedFileStrProperty, EmbeddedFileCount