LlDefineVariable

Syntax:

INT LlDefineVariable(HLLJOB hJob, LPCTSTR lpszName, LPCTSTR lpszCont);

Aufgabe:

Definiert eine Variable vom Typ LL_­TEXT und deren Inhalt.

Parameter:

hJob: List & Label-Job-Handle

lpszName: Zeiger auf Zeichenkette mit Variablenname

lpszCont: Zeiger auf Zeichenkette mit Variableninhalt

Rückgabewert:

Fehlercode

Hinweise:

Es gelten die allgemeinen Hinweise von Kapitel Hinweise zu Tabellen-, Variablen- und Feldnamen.

Diese Funktion definiert eine Textvariable, sie kann beliebig mit den anderen LlDefineVariable...()-Funktionen gemischt werden.

LlDefineVariable() ist identisch mit LlDefineVariableExt(..., LL_­TEXT, NULL).

Von List & Label sind schon folgende Variablen vorgegeben:

Variable

Bedeutung

LL.CountDataThisPage

Numerisch, definierte Daten­sätze pro Seite

LL.CountData

Numerisch, definierte Daten­sätze gesamt

LL.CountPrintedDataThisPage

Numerisch, gedruckte Daten­sätze pro Seite

LL.CountPrintedData

Numerisch, gedruckte Daten­sätze gesamt

LL.SortStrategy

Zeichenkette, Sortierausdruck

LL.FilterExpression

Zeichenkette, Filterausdruck

 

Der Unterschied von "definierten" zu "gedruckten" Datensätzen besteht darin, dass der Benutzer einen Filter auf die Datensätze anwenden kann, so dass mit jedem vom Programm gesendeten Datensatz sich die "definierten" Zahlen erhöhen, aber nicht unbedingt die "gedruckten" (letztere Werte werden nur dann erhöht, wenn der Datensatz gedruckt wurde).

Beispiel:

HLLJOB hJob;

hJob = LlJobOpen(0);
LlDefineVariableStart(hJob);
LlDefineVariable(hJob, "Name", "Normalverbraucher");
LlDefineVariable(hJob, "Vorname", "Otto");
LlDefineVariableExt(hJob, "Ort", "Konstanz", LL_­TEXT, NULL);
LlDefineVariableExt(hJob, "PLZ", "*78462*", LL_­BARCODE_­3OF9 , NULL);
<... etc ...>
LlJobClose(hJob);

Siehe auch:

LlDefineVariableStart, LlDefineVariableExt, LlDefineVariableExtHandle, LlGet­Variable­Contents, LlGetVariableType, LL_OPTION_VARS­CASESENSITIVE