Syntax:
INT LlSetPrinterInPrinterFile (HLLJOB hJob, UINT nObjType, LPCTSTR pszObjName, INT nPrinter, LPCTSTR pszPrinter, _PCDEVMODE pDM);
Aufgabe:
Ermöglicht die Veränderung von Druckerkonfigurationen in der Druckerkonfigurationsdatei.
Parameter:
hJob: List & Label-Job-Handle
nObjType: LL_PROJECT_LABEL, LL_PROJECT_LIST oder LL_PROJECT_CARD
pszObjName: Dateiname des Projekts mit Dateiendung
nPrinter: Druckerindex (0: Bereich mit "Page()==1" [wird notfalls angelegt], 1: Standardbereich, -1: legt nur den Standardbereich an, ggf. existierende andere Bereiche werden gelöscht).
Alternativ können – wenn im Projekt mehrere Layout-Bereiche verwendet werden - auch Indizes ab 99 gesetzt werden. 99 setzt dabei den Drucker für alle Bereiche, 100 für den ersten, 101 für den zweiten usw.
pszPrinter: Druckername
pDM: Zeiger auf die neue DEVMODE-Struktur. Kann NULL sein, dann wird der Drucker mit seinen momentanen Voreinstellungen eingetragen.
Rückgabewert:
Fehlercode
Hinweise:
Diese Funktion ermöglicht es Ihnen, einen (oder beide) Drucker in der Druckerkonfigurationsdatei einzutragen. Wenn keine existiert, wird sie angelegt. Durch Verodern des Projekttyps mit LL_PRJTYPE_OPTION_FORCEDEFAULTSETTINGS können Sie forcieren, dass die Standardeinstellungen des Druckers vorbelegt werden.
Da diese Datei von LlPrintStart() und LlPrintWithBoxStart() eingelesen wird, muss der Befehl VOR dem Aufruf dieser Funktionen durchgeführt werden.
Die DEVMODE-Struktur ist in der Windows-API definiert.
Durch die Möglichkeit, unterschiedliche Druck-Bereiche im Designer definieren zu können, ist die praktische Nutzbarkeit dieser Funktion sehr stark eingeschränkt, wenn Sie keine Kontrolle über das Layout haben. Wir empfehlen daher, in diesen Fällen über das LL-Objektmodell gemäß Kapitel Verwendung der DOM-API (ab Professional Edition) auf die Bereiche und die dort eingestellten Drucker zuzugreifen.
Über LL_OPTION_FORCE_DEFAULT_PRINTER_IN_PREVIEW lässt sich der Standarddrucker in der Vorschau setzen.
Diese und verwandte Funktionen, die die Druckerkonfigurationsdatei (die sog. "P-Datei") beeinflussen, um Druckereinstellungen zu ändern, können bei aktiviertem Printerless (siehe LL_OPTION_PRINTERLESS) nicht verwendet werden.
Siehe auch:
LlSetPrinterToDefault, LlPrintCopyPrinterConfiguration, LlSetPrinterDefaultsDir, LlGetPrinterFromPrinterFile