AddImageFromFileA

Image handling

Beskrivelse

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

Legger til et bilde fra en fil i det valgte dokumentet

Når et bilde er lagt til dokumentet, kan det tegnes på vilkårlige sider så mange ganger som ønsket uten at PDF-filen vokser mer

Støttede bildefiltyper er: BMP, TIFF, JPEG, PNG, GIF, WMF og EMF

PDF-versjonsvirkemåte: import av 16-biters bildedata per komponent krever PDF 1.5. Når et dokument er satt til PDF 1.4 eller lavere og lagringsversjonen ikke er låst, hever AddImageFromFile automatisk dokumentet til PDF 1.5 og registrerer 16-bit image samples i AutoBumpedFeatures. Hvis den som kaller låser en lavere lagringsversjon, avviser kompatibilitetssperren lagringen med LastErrorCode 602.

For BMP- og TIFF-bilder kan CompressImages-funksjonen kalles før denne funksjonen for å komprimere bildedataene. Andre bildetyper komprimeres automatisk

Syntaks

Delphi

Function DLAddImageFromFileA(InstanceID: Integer; FileName: PAnsiChar; Options: Integer): Integer;

DLL

int DLAddImageFromFileA(int InstanceID, const char * FileName, int Options);

Parametere

FileName	Filnavnet til bildet som skal legges til
Options	For TIFF-bilder med flere sider angir denne parameteren sidenummeret som skal lastes inn. For PNG-bilder: 0 = Last inn bildet som vanlig 1 = Last inn alfakanalen som et gråtonsbilde 2 = Last inn bildet og alfakanalen (begrens alfakanalen til 8-bit) 3 = Last inn bildet (begrens bildet til 8 bit/kanal) 4 = Last inn alfakanalen (begrens til 8 bit/kanal) 5 = Last inn bildet med alfakanal (begrens begge til 8 bit/kanal) 6 = Last inn bildet og alfakanalen 7 = Last inn bildet og ICC-fargeprofilen For andre bildetyper skal denne parameteren settes til 0. Å sette Options til -1 tvinger TIFF-, EMF- og WMF-bilder til å lastes inn med GDI+-grafikkbiblioteket. TIFF-bilder med flere sider kan også lastes inn med GDI+ ved å sette Options-parameteren til -PageNumber (for eksempel -3 for side 3)

FileName

Filnavnet til bildet som skal legges til

Options

For TIFF-bilder med flere sider angir denne parameteren sidenummeret som skal lastes inn. For PNG-bilder: 0 = Last inn bildet som vanlig 1 = Last inn alfakanalen som et gråtonsbilde 2 = Last inn bildet og alfakanalen (begrens alfakanalen til 8-bit) 3 = Last inn bildet (begrens bildet til 8 bit/kanal) 4 = Last inn alfakanalen (begrens til 8 bit/kanal) 5 = Last inn bildet med alfakanal (begrens begge til 8 bit/kanal) 6 = Last inn bildet og alfakanalen 7 = Last inn bildet og ICC-fargeprofilen For andre bildetyper skal denne parameteren settes til 0. Å sette Options til -1 tvinger TIFF-, EMF- og WMF-bilder til å lastes inn med GDI+-grafikkbiblioteket. TIFF-bilder med flere sider kan også lastes inn med GDI+ ved å sette Options-parameteren til -PageNumber (for eksempel -3 for side 3)

Returverdier

0	Bildet kunne ikke legges til. Enten ble det ikke funnet, eller det er i et format som ikke støttes
Non-zero	Bildet ble lagt til. ImageID returneres og kan sendes til funksjoner som SelectImage og DrawImage