LlDefineVariableExtHandle

Syntax:

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

Task:

Defines a variable and its contents.

Parameter:

hJob: List & Label job handle

lpszName: Pointer to a string with the name of the variable

hContents: Handle to an object of type:HMETAFILE, HENHMETAFILE,HICON or HBITMAP

lPara: LL_DRAWING_HMETA, LL_DRAWING_HEMETA, LL_DRAWING_HICON or LL_DRAWING_HBITMAP

lpPara: For future extensions, must be NULL.

Return Value:

Error code

Hints:

Please note the general hints in the section "Variables and Fields in List & Label".

This function can be mixed with the other LlDefineVariable...()-functions.

The handle must be valid as long as it is needed, that is during the entire layout definition or until after LlPrintFields() or LlPrint() return.

After use the handle can or should be deleted with the normal API function.

Example:

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

hMetaDC = CreateMetaFile(NULL); // curve
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(, 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", "Smith");
LlDefineVariable(hJob, "Forename", "George");
LlDefineVariableExtHandle(hJob, "Chart", hMeta,
                           LL_DRAWING_META, NULL);
LlDefineVariableExt(hJob, "Postal code", "*CB5 4RB*",                                               LL_BARCODE_3OF9, NULL);
<... etc ...>
LlJobClose(hJob);
DeleteObject(hMeta);