combit List & Label - Programmierer-Referenz - combit GmbH

Druckfortschrittsanzeige und Multitasking
Druckvorgang
Es ist üblich, dem Benutzer eine 'Abbrechen'-Dialogbox anzubieten, mit deren Hilfe er die
Möglichkeit erhält, den Ausdruck abzubrechen. Noch schöner ist es natürlich, wenn der
Benutzer durch diese Box auch noch mitgeteilt bekommt, wie weit der Druck fortgeschritten
ist.
List & Label bietet eine Funktion an, die eine Druck-Abbruch-Dialogbox mit Fortschrittsanzeiger
und dem Multitasking-Overhead startet. Diese Box kann dann mit den momentan
gültigen Werten (Fortschritt in Prozent, Seitennummer etc.) versorgt werden.
Durch Verwendung dieser Funktion spart man sich außerdem die Nachrichtenschleife,
weil diese in List & Label implementiert ist.
LlPrintWithBoxStart(hJob, LL_PROJECT_LABEL, buf, LL_PRINT_NORMAL,
LL_BOXTYPE_BRIDGEMETER, hWindow, "Mein Test");
Wenn von dieser Funktion kein Fehler zurückgegeben wurde, hat List & Label jetzt die
Definition des Projekts eingelesen und ist bereit zum Ausdruck. Der Drucker ist aber zu
diesem Zeitpunkt noch nicht initialisiert, das kommt erst bei dem ersten Aufruf einer
Funktion, die eine Ausgabe provoziert.
Denn jetzt kann (oder muss) man erst noch die Druckparameter einstellen. Wenn man
dem Benutzer die Änderung der Druckparameter gestatten will, ruft man den Dialog
dafür mit
LlPrintOptionsDialog(hJob, hWindow, "Druck-Parameter");
auf. Über LlSetOption() und LlSetOptionString() werden vor diesem Aufruf programmeigene
Standardwerte vorgegeben, man kann beispielsweise unerwünschte Auswahlfelder
im Dialog unterdrücken, z.B. über
LlPrintSetOption(hJob, LL_PRNOPT_COPIES, LL_COPIES_HIDE);
für die Abfrage nach der Zahl der Kopien.
Wenn man (siehe unten) schon jetzt weiß, wie viele Datensätze ausgegeben werden,
könnte man z.B. auch als Titelzeile anzeigen lassen, wie viele Datensätze oder Seiten zu
drucken sind.
Wenn im Dialog "Änderungen permanent" angekreuzt worden ist, wird die gewählte
Druckereinstellung in die entsprechende Drucker-Definitionsdatei gespeichert
(Schreib/Löschrechte müssen vorhanden sein), die alten Einstellungen gehen verloren.
Ursprünglich wird diese im Designer unter Datei-Seitenlayout bestimmt. Wenn diese
Datei nicht vorhanden ist, wird als Druckereinstellung der Windows-Standarddrucker
verwendet.
Einschränkungen der Druckseiten durch den Benutzer
Folgendes müssen Sie beachten, wenn man den Fall, dass der Anwender Anfangs- und
Endseiten angibt, speziell abfragen möchte: die Werte für Anfangs- und Endseite sind
Startseite und INT_MAX (2147483647), wenn "Druck aller Seiten" gewünscht ist. Startseite
ist die angegebene Seitennummer der ersten Seite.
41