PdfSavePage
PdfSavePage(alpha1, alpha2, int3[, point4[, point5[, int6[, alpha7]]]]) : int
Grafikdatei aus einer Seite des PDF-Dokuments erzeugen
Details
- alpha1: Dateiname der PDF-Datei
- alpha2: Dateiname der Grafik-Datei
- int3: Seitennummer
- point4: Größe des Bildes (optional)
- point5: Auflösung des Bildes (optional)
- int6: Qualität des Bildes (nur JPEG) (optional)
- alpha7: Kennwort der PDF-Datei (optional)
- Resultat:
intFehlerwert - Siehe: Verwandte Befehle
Der Befehl erzeugt eine Grafik-Datei aus einer Seite einer PDF-Datei. Der Pfad und der Name der PDF-Datei wird in (alpha1) angegeben. Die Angabe der zu erzeugenden Grafik-Datei erfolgt in (alpha2). Abhängig von der angegebenen Dateinamen-Erweiterung wird eine Datei des entsprechenden Formats erzeugt.
.jpg,.jpeg- JPEG-Grafik.tif,.tiff- TIFF-Grafik.png- PNG-Grafik.bmp- Windows-Bitmap
Bei anderen Erweiterungen oder wenn keine Erweiterung vorhanden ist, wird als Resultat _ErrGeneric zurückgegeben.
Ist die in (alpha2) angegebene Datei bereits vorhanden, wird sie überschrieben.
Die Seite, die in ein Bild gewandelt werden soll, wird in (int3) angegeben. Die Nummer muss im Bereich 1 bis Anzahl der Seiten im PDF liegen. Bei einem Wert außerhalb liefert die Anweisung das Resultat _ErrPdfPageNotExisting.
Die Größe des Bildes wird in (point4) angegeben. Wird das Argument nicht angegeben oder (0, 0) übergeben, wird die Seitengröße der PDF-Seite verwendet.
In (point5) kann die Auflösung des resultierendes Bildes angegeben werden. Die Komponente :x enthält dabei die horizontale, die Komponente :y die vertikale Auflösung. Wird das Argument nicht angegeben oder (0, 0) übergeben, wird ein Bild mit 72x72 DPI generiert. Ist nur einer der beiden Werte 0, dann ist die Auflösung in beiden Dimensionen identisch. D. h. bei der Übergaben von (300, 0) wird ein Bild mit der Auflösung 300x300 DPI erzeugt.
Handelt es sich bei der erzeugten Grafik um eine JPEG-Datei, kann in (int6) die Qualität des Bildes angegeben werden. Der Wert muss im Bereich 1 (schlecht) bis 100 (gut) liegen. Liegt er außerhalb wird er entsprechend modifiziert. Die Angabe wird bei anderen Grafik-Formaten ignoriert.
Ist das in (alpha1) angegebene PDF-Dokument durch ein Kennwort geschützt, muss dieses Kennwort in (alpha7) angegeben werden.
Die Anweisung gibt einen Fehlerwert zurück. Der Wert kann mit folgenden Konstanten verglichen werden:
_ErrOk: Datei wurde erfolgreich erstellt._ErrOutOfMemory: Speicher nicht ausreichend._ErrFsiInvalidFormat: Keine PDF-Datei oder PDF-Datei korrupt._ErrPdfPassword: PDF-Datei ist kennwortgeschützt bzw. Kennwort falsch._ErrGeneric: Ein unbekannter Fehler ist aufgetreten. Dieser Fehler wird auch zurückgegeben, wenn die Dateierweiterung der Ausgabedatei nicht zulässig ist._ErrPdfPageNotExisting: Die angegebene Seite existiert nicht._ErrFsiOpenFailed: Die Ausgabedatei konnte nicht angelegt werden._ErrFsiWriteFault: Fehler beim Schreiben der Ausgabedatei.