LlPrintFieldsEnd

Syntax:

INT LlPrintFieldsEnd (HLLJOB hJob);

Task:

Prints (tries to print) the footer on the last page and appended objects.

Parameter:

hJob: List & Label job handle

Return Value:

Error code

Hints:

Only needed in list projects.

Is necessary to make sure that the footer is printed, even if no other normal field data is available.

If the return value is LL_WRN_REPEAT_DATA, the footer could not be printed on the (last) page. LlPrintFieldsEnd() might have to be called multiple times to print the footer on another page.

If more tables are added via LlDbAddTable() the return value also can be LL_WRN_TABLECHANGE. Please refer to chapter Printing Relational Data for further information.

Example:

HLLJOB hJob;
hJob = LlJobOpen(0);

if (LlPrintStart(hJob, LL_PROJECT_LIST, "test.lst",
   LL_PRINT_NORMAL) == 0)
{
   <... etc...>

   <data finished>
   while (LlPrintFieldsEnd(hJob) == LL_WRN_REPEAT_DATA)
   {
      <define variables for next page>
      // allow user to abort
      LlPrintUpdateBox(hJob)
   }

   LlPrintEnd(hJob, 0);
}
else
   MessageBox(NULL, "Error", "List & Label", MB_OK);
LlJobClose(hJob);