AddEmbeddedFileA

Svojstva dokumenta

Opis

Sufiks A na kraju označuje ulaznu točku DLL-a vrste ANSI (char); sučelje ActiveX/COM izlaže samo oblik Unicode. Ponašanje je jednako AddEmbeddedFile, a znakovni argumenti tumače se pomoću trenutne kodne stranice SetAnsiMode

Ugrađuje datoteku u PDF kao tok ugrađene datoteke, ali sama po sebi ne registrira datoteku ni u jednom popisu kataloga niti crta klikabilnu anotaciju. Funkcija vraća ručku EmbeddedFileID koju možete proslijediti funkciji AddFileAttachment za dodavanje ikone spajalice na stranicu ili funkciji AddLinkToEmbeddedFile za stvaranje klikabilnog područja koje otvara datoteku. Ako želite i ugraditi datoteku i istodobno je navesti kao privitak na razini dokumenta u jednom pozivu, umjesto toga upotrijebite EmbedFile

Sintaksa

Delphi

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

DLL

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

Parametri

FileName	Puna putanja i naziv izvorne datoteke na disku. Njezini se bajtovi neizmijenjeni kopiraju u tok ugrađene datoteke PDF-a
MIMEType	MIME tip datoteke, na primjer `image/jpeg` ili `application/xml`. Može biti prazan niz kada MIME tip nije poznat

Povratne vrijednosti

0	Datoteka se nije mogla otvoriti ili nijedan dokument nije aktivan
Non-zero	Ručka EmbeddedFileID za upotrebu s AddFileAttachment, AddLinkToEmbeddedFile, ili SetEmbeddedFileStrProperty

Napomene

Ponašanje PDF verzije: tokovi ugrađenih datoteka i rječnici specifikacije datoteke zahtijevaju PDF 1.3. Ako je trenutačna verzija dokumenta niža i verzija spremanja nije zaključana, AddEmbeddedFile automatski podiže dokument na PDF 1.3. Pozivi koji registriraju datoteku kao privitak na razini dokumenta mogu zahtijevati višu verziju: AddFileAttachment i EmbedFile koriste PDF 1.4 stablo naziva /Names /EmbeddedFiles, a AddLinkToEmbeddedFile koristi PDF 1.4 neprozirnost/transparentnost izgleda anotacije

Datoteka ugrađena samo pomoću AddEmbeddedFile dio je PDF-a, ali je nevidljiva korisničkom sučelju čitača dok se ne registrira na popisu privitaka dokumenta ili dok se ne referencira anotacijom na stranici. Ponovna uporaba istog EmbeddedFileID s AddFileAttachment i AddLinkToEmbeddedFile omogućuje da jednu ugrađenu datoteku izložite kroz sučelje na razini dokumenta i kroz sučelje na razini stranice bez dupliciranja ugrađenih bajtova

PDF/A compatibility:

PDF/A-1, PDF/A-2 (SetPDFAMode načini 1–4) — ugrađene datoteke su zabranjene; poziv se odbija
PDF/A-3 (SetPDFAMode načini 5 i 6) — ugrađene datoteke bilo kojeg MIME tipa su dopuštene. Prije spremanja postavite odnos datoteke pomoću SetEmbeddedFileAFRelationship

Primjer

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

Vidi također

AddFileAttachment, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, SetEmbeddedFileStrProperty, EmbeddedFileCount