AddImageFromFileA

Képkezelés

Leírás

A záró A az ANSI (char) DLL-belépési pontot jelöli; az ActiveX/COM felület csak az Unicode alakot teszi elérhetővé. A működés megegyezik az AddImageFromFile működésével, a karakterláncargumentumokat pedig az aktuális SetAnsiMode kódlap szerint értelmezi

Fájlból származó képet ad a kijelölt dokumentumhoz

Miután egy kép a dokumentumhoz lett adva, bármely oldalon többször is kirajzolható a PDF-fájl méretének további növelése nélkül

A támogatott képfájltípusok: BMP, TIFF, JPEG, PNG, GIF, WMF és EMF

PDF-verzió viselkedése: a 16 bites komponensenkénti képadatok importálásához PDF 1.5 szükséges. Ha a dokumentum PDF 1.4 vagy korábbi verzióra van állítva, és a mentési verzió nincs zárolva, az AddImageFromFile automatikusan PDF 1.5-re emeli a dokumentumot, és a 16-bit image samples értéket rögzíti az AutoBumpedFeatures mezőben. Ha a hívó alacsonyabb mentési verziót zárol, a kompatibilitási kapu LastErrorCode 602 hibával elutasítja a mentést

BMP és TIFF képek esetén a CompressImages függvény e függvény előtt hívható a képadatok tömörítésére. Más képtípusok automatikusan tömörülnek

Szintaxis

Delphi

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

DLL

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

Paraméterek

FileName	A hozzáadandó kép fájlneve
Options	Többoldalas TIFF-képeknél ez a paraméter a betöltendő oldalszámot adja meg. PNG-képeknél: 0 = Kép szokásos betöltése 1 = Alfa-csatorna betöltése szürkeárnyalatos képként 2 = Kép és alfa-csatorna betöltése (alfa 8 bitesre korlátozva) 3 = Kép betöltése (8 bit/csatornára korlátozva) 4 = Alfa-csatorna betöltése (8 bit/csatornára korlátozva) 5 = Kép betöltése alfa-csatornával (mindkettő 8 bit/csatornára korlátozva) 6 = Kép és alfa-csatorna betöltése 7 = Kép és ICC-színprofil betöltése. Más képtípusoknál a paramétert 0-ra kell állítani. Az Options -1 értéke a TIFF-, EMF- és WMF-képek GDI+ grafikus könyvtárral történő betöltését kényszeríti. Többoldalas TIFF-képek GDI+-szal is betölthetők, ha az Options paraméter értéke -PageNumber (például a 3. oldalhoz -3)

FileName

A hozzáadandó kép fájlneve

Options

Többoldalas TIFF-képeknél ez a paraméter a betöltendő oldalszámot adja meg. PNG-képeknél: 0 = Kép szokásos betöltése 1 = Alfa-csatorna betöltése szürkeárnyalatos képként 2 = Kép és alfa-csatorna betöltése (alfa 8 bitesre korlátozva) 3 = Kép betöltése (8 bit/csatornára korlátozva) 4 = Alfa-csatorna betöltése (8 bit/csatornára korlátozva) 5 = Kép betöltése alfa-csatornával (mindkettő 8 bit/csatornára korlátozva) 6 = Kép és alfa-csatorna betöltése 7 = Kép és ICC-színprofil betöltése. Más képtípusoknál a paramétert 0-ra kell állítani. Az Options -1 értéke a TIFF-, EMF- és WMF-képek GDI+ grafikus könyvtárral történő betöltését kényszeríti. Többoldalas TIFF-képek GDI+-szal is betölthetők, ha az Options paraméter értéke -PageNumber (például a 3. oldalhoz -3)

Visszatérési értékek

0	A kép nem adható hozzá, mert nem található vagy nem támogatott formátumú
Non-zero	A kép hozzáadása sikerült. A rendszer visszaadja az ImageID azonosítót, amely átadható például a SelectImage és a DrawImage függvényeknek