Es gibt verschiedene Typen von Parametern, die sich durch den Übergabeparameter nFlags bei LlSetDefaultProjectParameter() unterscheiden. Jeweils eins der nachfolgenden drei Flag-Alternativen muss angegeben werden:
|
LL_PARAMETERFLAG_FORMULA |
Der Parameter ist eine Formel, die beim Druck ausgewertet wird. Über LlPrintGetProjectParameter() bekommt man den berechneten Wert zurück (Voreinstellung). |
|
LL_PARAMETERFLAG_VALUE |
Der Parameter ist ein fester Wert. Über LlPrintGetProjectParameter() bekommt man diesen Wert unverändert zurück (Voreinstellung). |
|
LL_PARAMETERFLAG_PUBLIC |
Der Parameter erscheint im Designer, wenn kein Objekt selektiert ist. Der Benutzer kann die Formel bzw. den Wert ändern (Voreinstellung). |
|
LL_PARAMETERFLAG_PRIVATE |
Der Parameter kann durch den Benutzer (d. h. im Designer) nicht geändert werden. |
|
LL_PARAMETERFLAG_GLOBAL |
Der Parameter wird in die Druck-Projektparameterliste übernommen und ggf. in der Vorschaudatei gespeichert und kann daraus wieder abgerufen werden (LlStgsysGetJobOptionStringEx()) (Voreinstellung). |
|
LL_PARAMETERFLAG_LOCAL |
Der Parameter wird nicht in die Druck-Projektparameterliste übernommen und in der Vorschaudatei gespeichert, da er nur für den lokalen Benutzer oder Rechner gültig ist. Diese Werte existieren nur in der DefaultProjectParameter-Liste, sind also eine Art lokale Variable (die aber auch an die über LlPreviewDisplay() angezeigte Vorschau übergeben werden, da diese als "lokal" angesehen werden kann) (Voreinstellung). |
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". Unveränderte Parameter werden in der Projektlayoutdatei nicht gespeichert, so dass spätere Änderungen der voreingestellten 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 voreingestellte 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.