Syntax:

INT LlDefineVariableExtHandle(HLLJOB hJob, LPSTR lpszName, HANDLE hContents, INT lPara, LPVOID lpPara);

Aufgabe:

Definiert eine Variable und deren Inhalt.

Parameter:

hJob: List & Label-Job-Handle

lpszName: Zeiger auf Zeichenkette mit Variablenname

hContents: Handle (HMETAFILE, HENHMETAFILE, HICON oder HBITMAP)

lPara: LL_­DRAWING_­HMETA, LL_­DRAWING_­HEMETA, LL_­DRAWING_­HICON oder LL_­DRAWING_­HBITMAP

lpPara: für spätere Erweiterungen, muss NULL oder "" (Leerstring) sein (siehe LlDefineFieldExt)

Rückgabewert:

Fehlercode

Hinweise:

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

Diese Funktion kann beliebig mit den anderen LlDefineVariable...()-Funktionen gemischt werden.

Das Handle muss so lange gültig sein, wie es gebraucht wird, also während der gesamten Layout-Definition oder bis nach LlPrintFields() bzw. LlPrint().

Nach der Verwendung kann bzw. sollte es über die übliche API-Funktion gelöscht werden.

Beispiel:

HLLJOB hJob;
HMETAFILE hMeta;
HDC hMetaDC;
INT i;

hMetaDC = CreateMetaFile(NULL); // Fieberkurve
SelectObject(hMetaDC, GetStockObject(NULL_­PEN));
Rectangle(hMetaDC, 0, 0, LL_­META_­MAXX, LL_­META_­MAXY);

for (i = 0; i < 10; ++i)
{
   MoveTo(hMetaDC,0,MulDiv(i, LL_­META_­MAXY, 10));
   LineTo(hMetaDC,MulDiv(i, LL_­META_­MAXX, 100), MulDiv(i, LL_­META_­MAXY,10);
}
MoveTo(hMetaDC,0,MulDiv(((100*i) & 251) % 100, LL_­META_­MAXY,100));
for (i = 0; i < 10; ++i)
   LineTo(hMetaDC,MulDiv(i, LL_­META_­MAXX, 10),MulDiv(((100*i) & 251) % 100,
            LL_­META_­MAXY,100));
hMeta = CloseMetaFile(hMetaDC);

hJob = LlJobOpen(0);
LlDefineVariableStart(hJob);
LlDefineVariable(hJob, "Name", "Normalverbraucher");
LlDefineVariable(hJob, "Vorname", "Otto");
LlDefineVariableExtHandle(hJob, "Chart", hMeta, LL_­DRAWING_­HMETA, NULL);
LlDefineVariableExt(hJob, "PLZ", "*78462*", LL_­BARCODE_­3OF9, NULL);
<... etc ...>
LlJobClose(hJob);
DeleteObject(hMeta);

Siehe auch:

LlDefineVariableStart, LlDefineVariable, LlDefineVariableExt, LlGetVariable­Contents, LlGetVariableType, LL_OPTION_VARS­CASESENSITIVE