Syntax:
INT LlStgsysConvert (HLLSTG hStg, LPCTSTR pszDstFilename, LPCTSTR pszFormat);
Aufgabe:
Konvertiert eine Vorschaudatei in ein anderes Format.
Parameter:
hStg: Das von LlStgsysStorageOpen() zurückgelieferte Handle
pszDstFilename: Name der Zieldatei. Dieser kann auch den Formatierungsplatzhalter %d enthalten (z. B. "Seite %d"). Dies ist wichtig z. B. für JPEG-Konvertierung, da sonst nur eine einzige Seite erzeugt werden würde.
pszFormat: Gewünschtes Zielformat. Erlaubte Werte:
|
Wert |
Bedeutung |
|
PRN |
Drucker |
|
PRV bzw. LL |
Vorschau |
|
|
Adobe PDF-Format |
|
XHTML * |
XHTML/CSS-Format |
|
MHTML * |
Multi-Mime-HTML-Format |
|
XLS * |
Microsoft Excel-Format |
|
DOCX * |
Microsoft Word-Format |
|
XPS |
Microsoft XPS-Format |
|
TIFF bzw. PICTURE_MULTITIFF |
TIFF-Grafik (mehrseitig) |
|
PNG bzw. PICTURE_PNG |
PNG-Grafik |
|
JPEG bzw. PICTURE_JPEG |
JPEG-Grafik |
|
EMF |
Metafile-Grafik (EMF) |
|
TTY |
Nadeldrucker (TTY) |
|
TXT |
Text (CSV)-Format |
* nur, wenn in der Vorschaudatei eingebettet, siehe LL_OPTIONSTR_EMBEDDED_EXPORTS
Über diesen Parameter kann eine semikolonseparierte Liste mit darin enthaltenen exporterspezifischen Optionen für die Konvertierung gesetzt werden. Die möglichen Parameter finden Sie im Kapitel über die Exportmodule dokumentiert. Beachten Sie, dass nicht alle dort angegebenen Parameter berücksichtigt werden können. Ein Beispiel wäre die Übergabe von "PDF; PDF.Encryption.EncryptFile=1".
Zusätzlich zu den im o. g. Kapitel beschriebenen Parametern können die folgenden Parameter übergeben werden:
|
Wert |
Bedeutung |
|
PageIndexRange |
Analog zum Druckdialog kann ein Bereich für die Seiten angegeben werden. |
|
JobIndexRange |
Analog zum Druckdialog kann ein Bereich für den Job angegeben werden. |
|
IssueIndexRange |
Analog zum Druckdialog kann ein Bereich für die Ausfertigungen angegeben werden. |
Ein Beispiel hierfür wäre die Verwendung von "PDF;Export.PageIndexRange=2-3". Damit werden lediglich die Seiten 2 und 3 in das erzeugte PDF aufgenommen.
Der Export auf PRN erzeugt eine Datei, die speziell für den angegebenen Drucker (Parameter "PRN.Device=") aufbereitet wird und über direktes Kopieren auf den Drucker ausgegeben werden kann. Daher muss der Druckername (Device-Name) auch explizit übergeben werden.
Rückgabewert:
0: okay, <0: Fehlercode
Hinweise:
-
Beispiel:
HLLSTG hStgOrg;
hStgOrg =
LlStgsysStorageOpen("c:\\test\\label1.ll", "", FALSE,
TRUE);
LlStgsysConvert(hStgOrg, "c:\\test\\label2.pdf",
"PDF");
LlStgsysStorageClose(hStgOrg);
Siehe auch:
LlStgsysStorageOpen, LlStgsysStorageConvert