combit List & Label - Programmierer-Referenz - combit GmbH

15.2.4. Export-spezifische Optionen setzen
Die Programmierschnittstelle der Export-Module
Die Export-spezifischen Optionen werden über die Funktion LlXSetParameter gesetzt
und über LlXGetParameter abgefragt. Die Optionen sind Export-Modul spezifisch, daher
muss bei diesen Funktionen auch explizit der Name des Export-Moduls übergeben werden.
Wo sinnvoll können die Optionen auch simultan für alle Export-Module gesetzt
werden (z.B. "Export.ShowResult"), indem einfach ein Leerstring ("") als Name für das
Export-Modul übergeben wird. Die jeweils unterstützten Optionen und ihre Bedeutung
werden in den nachfolgenden Kapiteln bei den einzelnen Export-Modulen erläutert.
Ein Teil der Optionen kann auch durch den Endanwender interaktiv im Eigenschaftsdialog
des jeweiligen Export-Moduls eingestellt werden (entweder im Designer oder im
Druckoptionsdialog). Diese Optionen werden dann automatisch in der Druckerdefinitionsdatei
(das "P-File") gespeichert und sind demnach Projektdatei-spezifisch.
15.2.5. Export ohne Benutzerinteraktion durchführen
Soll ein Export ohne Benutzerinteraktion durchgeführt werden, so kann dies durch den
Einsatz der bisher besprochenen Funktionen realisiert werden.
Beispiel:
Angenommen, die Anwendung möchte ohne Benutzerinteraktion das Listenprojekt
'Artikel.lst' in das HTML-Dokument 'export.htm' im Verzeichnis 'c:\temp' exportieren:
//...
LlXSetParameter(hJob, LL_LLX_EXTENSIONTYPE_EXPORT, "HTML",
"Export.File", "export.htm");
LlXSetParameter(hJob, LL_LLX_EXTENSIONTYPE_EXPORT, "HTML",
"Export.Path", "c:\\temp\\");
LlXSetParameter(hJob, LL_LLX_EXTENSIONTYPE_EXPORT, "HTML",
"Export.Quiet", "1");
LlPrintWithBoxStart(hJob, LL_PROJECT_LIST, "Artikel.lst",
LL_PRINT_EXPORT, LL_BOXTYPE_BRIDGEMETER, hWnd,"HTML");
LlPrintSetOptionString(hJob, LL_PRNOPTSTR_EXPORT, "HTML");
//... Normale Druckschleife ...
Das war es schon! Die Bedeutung der HTML-Export-spezifischen Optionen entnehmen
Sie bitte dem nachfolgenden Kapitel.
15.2.6. Export-Ergebnis abfragen
Um das Export-Ergebnis weiterzuverarbeiten, können über die Option
LL_OPTIONSTR_EXPORTFILELIST alle durch den Druck/Export generierten Dateien ermittelt
werden: Wenn diese Option per LlGetOptionString() nach LlPrintEnd(), also nach
einem durchgeführten Druck, abgefragt wird, so erhält man eine Semikolon-separierte
Liste aller Dateien (inkl. Verzeichnis), die durch den Druck generiert wurden. Bei einem
HTML-Export wären dies bspw. alle erzeugten HTML- und JPEG-Dateien, bei einem
Druck auf Vorschau lediglich die eine generierte LL-Vorschaudatei.
Die beim Export generierten Dateien werden nicht automatisch gelöscht, sondern müssen
ggf. durch das Anwendungsprogramm entfernt werden.
325