AddEmbeddedFileA

Dokumentum tulajdonságai

Leírás

A záró A a DLL ANSI-belépési pontját (char) jelöli; az ActiveX/COM felület csak a Unicode formát teszi elérhetővé. A működés megegyezik ezzel: AddEmbeddedFile, és a sztringargumentumok a jelenlegi SetAnsiMode kódlap alapján értelmeződnek

Fájlt ágyaz be a PDF-be beágyazott fájl adatfolyamként, de önmagában nem jegyzi be a fájlt semmilyen katalóguslistába, és nem rajzol kattintható annotációt. A függvény egy EmbeddedFileID fogantyút ad vissza, amely átadható az AddFileAttachment függvénynek (gemkapocsikon oldalhoz csatolásához) vagy az AddLinkToEmbeddedFile függvénynek (a fájlt megnyitó kattintható hotspot létrehozásához). Fájl egyetlen hívással történő beágyazásához és dokumentumszintű mellékletként való felsorolásához használja inkább az EmbedFile függvényt

Szintaxis

Delphi

Function DLAddEmbeddedFileA(InstanceID: Integer; FileName, MIMEType: PAnsiChar): Integer;

DLL

int DLAddEmbeddedFileA(int InstanceID, const char * FileName, const char * MIMEType);

Paraméterek

FileName	A lemezen található forrásfájl teljes elérési útja és neve. A bájtjai változatlanul egy PDF-beágyazott fájlfolyamba másolódnak
MIMEType	A fájl MIME-típusa, például `image/jpeg` vagy `application/xml`. Üres karakterlánc lehet, ha a MIME-típus ismeretlen

Visszatérési értékek

0	A fájlt nem lehetett megnyitni, vagy nincs aktív dokumentum
Non-zero	EmbeddedFileID fogantyú az AddFileAttachment, AddLinkToEmbeddedFile vagy SetEmbeddedFileStrProperty használatához

Megjegyzések

PDF-verzióviselkedés: a beágyazott fájlok adatfolyamai és a fájlspecifikációs szótárak PDF 1.3 verziót igényelnek. Ha az aktuális dokumentumverzió alacsonyabb és a mentési verzió nincs zárolva, az AddEmbeddedFile automatikusan PDF 1.3-ra emeli a dokumentumot. A fájlt dokumentumszintű mellékletként regisztráló hívások magasabb verziót igényelhetnek: az AddFileAttachment és az EmbedFile a PDF 1.4 /Names /EmbeddedFiles névfáját, az AddLinkToEmbeddedFile pedig a PDF 1.4 megjegyzés-átlátszatlanságát és megjelenési átlátszóságát használja

A kizárólag AddEmbeddedFile használatával beágyazott fájl a PDF része, de az olvasó felületén láthatatlan marad, amíg nem regisztrálják a dokumentummellékletek listájában vagy nem hivatkozik rá oldalmegjegyzés. Ugyanazon EmbeddedFileID újrafelhasználása az AddFileAttachment és AddLinkToEmbeddedFile függvényekkel lehetővé teszi egy beágyazott fájl megjelenítését a dokumentumszintű és az oldalszintű felületen is a beágyazott bájtok megkettőzése nélkül

PDF/A-kompatibilitás:

PDF/A-1, PDF/A-2 (SetPDFAMode 1–4. mód) — a beágyazott fájlok tiltottak; a hívás elutasításra kerül
PDF/A-3 (SetPDFAMode 5., 6. és 7. mód) — bármely MIME típusú beágyazott fájl engedélyezett. Mentés előtt állítsa be a fájl kapcsolatát a SetEmbeddedFileAFRelationship segítségével

Példa

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

Lásd még

AddFileAttachment, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, SetEmbeddedFileStrProperty, EmbeddedFileCount