AddImageFromFileOffsetA

Bildverarbeitung

Beschreibung

Das abschließende A kennzeichnet den ANSI-Einstiegspunkt (char) der DLL; die ActiveX/COM-Oberfläche stellt nur die Unicode-Form bereit. Das Verhalten entspricht AddImageFromFileOffset, und Zeichenfolgenargumente werden anhand der aktuellen Codepage von SetAnsiMode interpretiert

Prüfen Sie Syntax, Parameter und Rückgabewerte, bevor Sie die Funktion aufrufen Die Codeblöcke bleiben im Original erhalten, damit Beispiele unverändert übernommen werden können.

Verhalten der PDF-Version: Das Importieren von Bilddaten mit 16 Bit pro Komponente erfordert PDF 1.5. Ist ein Dokument auf PDF 1.4 oder niedriger eingestellt und die Speicherversion nicht gesperrt, hebt AddImageFromFileOffset das Dokument automatisch auf PDF 1.5 an und trägt 16-bit image samples in AutoBumpedFeatures ein. Sperrt der Aufrufer eine niedrigere Speicherversion, lehnt die Kompatibilitätsprüfung das Speichern mit LastErrorCode 602 ab.

Prüfen Sie Syntax, Parameter und Rückgabewerte, bevor Sie die Funktion aufrufen Die Codeblöcke bleiben im Original erhalten, damit Beispiele unverändert übernommen werden können.

Syntax

Delphi

Function DLAddImageFromFileOffsetA(InstanceID: Integer; FileName: PAnsiChar; Offset, DataLength, Options: Integer): Integer;

DLL

int DLAddImageFromFileOffsetA(int InstanceID, const char * FileName, int Offset, int DataLength, int Options);

Parameter

FileName	Der Name der Datei, die die Bilder enthält.
Offset	Der Offset innerhalb der Datei, an dem das benötigte Bild beginnt. Das erste Byte der Datei hat den Offset 0.
DataLength	Die Länge der Bilddaten in Bytes
Options	Bei mehrseitigen TIFF-Bildern gibt dieser Parameter die zu ladende Seitennummer an. Für PNG-Bilder: 0 = Bild wie üblich laden 1 = Alphakanal als Graustufenbild laden 2 = Bild und Alphakanal laden (Alpha auf 8 Bit begrenzen) 3 = Bild laden (Bild auf 8 Bit/Kanal begrenzen) 4 = Alphakanal laden (auf 8 Bit/Kanal begrenzen) 5 = Bild mit Alphakanal laden (beide auf 8 Bit/Kanal begrenzen) 6 = Bild und Alphakanal laden 7 = Bild und ICC-Farbprofil laden Bei anderen Bildtypen sollte dieser Parameter auf 0 gesetzt werden. Options = -1 erzwingt, dass TIFF-, EMF- und WMF-Bilder mit der Grafikbibliothek GDI+ geladen werden. Mehrseitige TIFF-Bilder können ebenfalls mit GDI+ geladen werden, indem der Parameter Options auf -PageNumber gesetzt wird (beispielsweise -3 für Seite 3).

Rückgabewerte

0	Das Bild konnte nicht aus der Datei gelesen werden. Dies kann auf ungültige Bilddaten hindeuten oder darauf, dass die Datei nicht gefunden wurde.
Non-zero	Das Bild wurde aus der Datei gelesen und erfolgreich dem Dokument hinzugefügt. Der zurückgegebene Wert ist die ID des Bilds, die mit Bildzeichenfunktionen wie DrawImage verwendet werden kann.