AddEmbeddedFileA

Dokumentegenskaper

Beskrivelse

Den avsluttende A angir ANSI-inngangspunktet (char) i DLL-en; ActiveX/COM-flaten eksponerer kun Unicode-formen. Oppførselen er identisk med AddEmbeddedFile og strengargumenter tolkes ut fra gjeldende kodetabell i SetAnsiMode

Bygger inn en fil i PDF-en som en embedded file-strøm, men registrerer den ikke av seg selv i noen catalog-liste og tegner ingen klikkbar annotasjon. Funksjonen returnerer et EmbeddedFileID-håndtak som kan sendes til AddFileAttachment (for å feste et binders-ikon på en side) eller AddLinkToEmbeddedFile (for å opprette en klikkbar hotspot som åpner filen). For både å bygge inn en fil og oppføre den som dokumentnivå-vedlegg i ett kall, bruk EmbedFile i stedet

Syntaks

Delphi

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

DLL

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

Parametere

FileName	Full sti og navn på kildefilen på disk. Bytene kopieres ordrett inn i en PDF embedded file-strøm
MIMEType	MIME-typen til filen, for eksempel `image/jpeg` eller `application/xml`. Kan være en tom streng når MIME-typen er ukjent

Returverdier

0	Filen kunne ikke åpnes, eller ingen dokument er aktivt
Non-zero	Et EmbeddedFileID-håndtak til bruk med AddFileAttachment, AddLinkToEmbeddedFile eller SetEmbeddedFileStrProperty

Merknader

PDF-versjonsoppførsel: embedded file-strømmer og filspesifikasjonsordbøker krever PDF 1.3. Hvis gjeldende dokumentversjon er lavere og lagringsversjonen ikke er låst, hever AddEmbeddedFile automatisk dokumentet til PDF 1.3. Kall som registrerer filen som dokumentnivå-vedlegg kan kreve høyere versjon: AddFileAttachment og EmbedFile bruker PDF 1.4 /Names /EmbeddedFiles-navnetreet, og AddLinkToEmbeddedFile bruker PDF 1.4 annotasjonsdekkevne/utforming-gjennomsiktighet

En fil som bare er bygget inn med AddEmbeddedFile, er en del av PDF-en, men usynlig for leserens UI før den er registrert i dokumentets vedleggsliste eller refereres av en sideannotasjon. Å gjenbruke samme EmbeddedFileID med AddFileAttachment og AddLinkToEmbeddedFile lar deg eksponere én innebygd fil gjennom både dokumentnivå- og sidenivå-UI uten å duplisere de innebygde bytene

PDF/A compatibility:

PDF/A-1, PDF/A-2 (SetPDFAMode modes 1–4) — embedded files are forbidden; the call is rejected.
PDF/A-3 (SetPDFAMode modes 5, 6, and 7) — embedded files of any MIME type are permitted. Set the file's relationship via SetEmbeddedFileAFRelationship before saving.

Eksempel

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

Se også

AddFileAttachment, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, SetEmbeddedFileStrProperty, EmbeddedFileCount