Zum Hauptinhalt springen

PdfInsertImage

obj -> PdfInsertImage(alpha1, float2, float3, float4, float5, int6[, int7]) : int​

Ausführbar von Clients mit grafischer Oberfläche Ausführbar vom Server Ausführbar von der DLL-Schnittstelle mit grafischer Erweiterung Ausführbar von der Web-Schnittstelle Ausführbar vom Druckprozessor Ausführbar von der ODBC-Schnittstelle Ausführbar vom SOA-Service mit grafischer Erweiterung

Bild einfügen (BMP, GIF, JPEG, PNG und TIFF)

Details

  • obj: Deskriptor des PDF-Objekts
  • alpha1: Pfad- und Dateiname des Bildes
  • float2: Abstand vom linken Seitenrand
  • float3: Abstand vom oberen Seitenrand
  • float4: Breite des Bildes
  • float5: Höhe des Bildes
  • int6: Seitennummer
  • int7: Größenanpassung des Bildes oder des PDFs (optional)
  • Resultat: int Fehlerwert
  • Siehe: Verwandte Befehle

Die Anweisung fügt ein Bild der Formate BMP, GIF, JPEG, PNG oder TIFF in die zum Bearbeiten geöffnete Seite ein. Die Seite muss zuvor mit der Anweisung PdfPageOpen () geöffnet werden. Das Bild wird an der angegebenen Position (float2 und float3) in der angegebenen Größe (float4 und float5) eingefügt. Die Positions- und Größenangaben erfolgen in Millimeter.

Beinhaltet die Bild-Datei mehr als ein Bild (zum Beispiel bei einem Multipage-TIFF), wird der Index des Bildes in (int6) übergeben.

Soll eine Anpassung der Größe des Bildes oder der Seite des PDF-Dokuments vorgenommen werden, kann eine der folgenden Konstanten in (int7) angegeben werden:

  • _PdfInsertNormal Das Bild wird ohne Anpassungen des Bildes oder des PDF-Dokuments eingefügt.
  • _PdfInsertFitImage Das Bild wird an das Pdf angepasst. Es wird entweder an die Seitenhöhe oder die Seitenbreite angepasst, sodass das komplette Bild in der maximalen Größe dargestellt wird. Das Verhältnis der Höhe zur Breite bleibt bestehen.
  • _PdfInsertFitPdf Das Pdf wird auf die Größe des Bildes angepasst. Dabei kann bei den Parametern (float4) und (float5) angegeben werden, ob die Originalgröße des Bildes beibehalten werden soll (-1.0), oder es können die gewünschten Werte in Millimeter übergeben werden.
  • _PdfOptUseLogSize Wird diese Konstante mit der Konstanten _PdfInsertFitImage oder _PdfInsertFitPdf kombiniert, wird beim Skalieren die logische Größe des Bildes berücksichtigt. Bei Kombination mit _PdfInsertFitPdf muss die Breite (float4) und die Höhe (float5) jeweils -1.0 sein.
  • _PdfOptBlendMultiply Mit der Option _PdfOptBlendMultiply kann erreicht werden, dass das einzufügende Bild mit dem aktuellen Inhalt des PDF gemischt wird. Das Bild erscheint dann hinter dem vorhandenen Inhalt des PDFs liegt.
info

Die eingefügten Bilder werden anhand der übergebenen Argumente zwischengespeichert. Bei erneutem Aufruf mit den selben Argumenten, wird das bereits gespeicherte Bild eingefügt. Die Größe und das Änderungsdatum der Datei werden hierbei nicht berücksichtigt.

Der Rückgabewert kann mit folgenden Konstanten verglichen werden:

Mögliche Laufzeitfehler: