LlDefineFieldExt

Syntax:

INT LlDefineFieldExt (HLLJOB hJob, LPCTSTR lpszName, LPCTSTR lpszCont, INT lPara, LPVOID lpPara);

Task:

Defines a list/table field and its contents.

Parameter:

hJob: List & Label job handle

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

lpszCont: Pointer to a string with the contents of the field

lPara: Field type (LL_TEXT, LL_NUMERIC, ...), if necessary OR-ed (see below).

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".

List & Label predefines the fields listed in LlDefineField().

lPara OR-ed with LL_TABLE_FOOTERFIELD supplies field definitions only for the list footer. The footer is dynamically linked to the list body and is suitable for, e.g., dynamic calculations as the line for totals or sub-totals.

lPara OR-ed with LL_TABLE_HEADERFIELD supplies field definitions only for the list header.

lPara OR-ed with LL_TABLE_GROUPFIELD supplies field definitions only for the group.

lPara OR-ed with LL_TABLE_GROUPFOOTERFIELD supplies field definitions only for the group footer.

lPara OR-ed with LL_TABLE_BODYFIELD supplies field definitions only for the list body.

If none of these flags is used, the fields appear in all field selection dialogs in the table object.

Example:

HLLJOB hJob;

hJob = LlJobOpen(0);
LlDefineFieldStart(hJob);
LlDefineField(hJob, "Name", "Smith");
LlDefineField(hJob, "Forename", "George");
LlDefineFieldExt(hJob, "Residence", "Cambridge", LL_TEXT, NULL);
LlDefineFieldExt(job, "Number of entries per page",
   "1", LL_TABLE_FOOTERFIELD Or LL_TEXT, NULL)
LlDefineFieldExt(hJob, "Postal code",
   "*CB5 9NB*", LL_BARCODE_3OF9);
LlDefineFieldExt(hJob, "Photo",
   "c:\\photos\\norm.bmp", LL_DRAWING);
<... etc ...>
LlJobClose(hJob);