combit List & Label - Programmierer-Referenz - combit GmbH

Grundlagen
sind also eine Art lokale Variable (die aber auch an die über LlPreviewDisplay()
angezeigte Vorschau übergeben werden, da diese als "lokal" angesehen werden
kann).
Wenn die Parameter über LlSetDefaultProjectParameter() definiert werden, sind das die
Voreinstellungen, die der Benutzer gegebenenfalls (wenn LL_PARAMETERFLAG_PUBLIC
gesetzt ist) seinen Bedürfnissen entsprechend einstellen kann.
Wird das Projekt dann geladen (LlDefineLayout(), LlPrint[WithBox]Start()), werden die
Parameter durch die im Projekt gespeicherten Formeln oder Werte ersetzt, d.h. überschrieben.
Um dies zu verdeutlichen, heißt die API "DefaultParameters". Ungeänderte
Parameter werden im Projektlayoutfile nicht gespeichert, so dass spätere Änderungen
der Default-Parameter für den Druck übernommen werden. Ist dies nicht gewünscht, so
können Sie zusätzlich das Flag LL_PARAMETERFLAG_SAVEDEFAULT mit angeben, damit
der Default-Wert im Projektfile gespeichert wird. Dies ist insbesondere nützlich, um vom
Benutzer im Designer gesetzte Projektparameter vor dem Druck per LlGetProjectParameter
auszulesen.
Es darf nicht mehrere Parameter mit gleichem Namen, aber verschiedenem Typ geben!
Der Typ wird durch LlSetDefaultProjectParameter() festgelegt.
12.1.2. Druck des Projekts
Nach dem Start des Drucks über LlPrint[WithBox]Start() sind die für den Druck verbindlichen
Werte über LlPrintGetProjectParameter() abfragbar, entweder als Formel oder als
berechneter Wert.
Man kann auch über LlPrintSetProjectParameter() den Wert noch einmal ändern oder
sogar neue Parameter hinzufügen. Dies macht dann Sinn, wenn man die Werte später
noch braucht, denn sie werden – nach einer eventuellen Formelevaluierung - in der Vorschaudatei
gespeichert und können über LlStgsysGetJobOptionStringEx() abgefragt
werden. Somit kann man eigene Parameter dauerhaft darin speichern. Dort beginnen die
Parameter mit "ProjectParameter." vor dem definierten Namen.
12.1.3. Vordefinierte Projektparameter
List & Label verwendet Projektparameter zum Versand per Fax oder eMail. Der Benutzer
kann die Parameter übernehmen oder abändern, z.B. den Fax- oder eMail-Empfänger
über eine Formel, die von der Applikation angebotene Variablen enthält, übernehmen.
Da List & Label bei der Übergabe der Fax- bzw. Mail-Parameter eine Formel erwartet,
kann es notwendig sein, den übergebenen Wert als Zeichenkette zu maskieren (dann,
wenn ein fester Wert übergeben werden soll).
Beispiel:
LlPrintSetProjectParameter(hJob, "LL.FAX.RecipNumber",
T("""+497531906018"""), 0);
161