LlPrintSetBoxText

Syntax:

INT LlPrintSetBoxText (HLLJOB hJob, LPCTSTR lpszText, INT nPercentage);

Task:

Sets text and meter percentage value in the abort dialog box.

Parameter:

hJob: List & Label job handle

lpszText: Text which should appear in the box

nPercentage: Progress percentage

Return Value:

Error code

Hints:

To make the text multi-line, line feeds ('\x0a') can be inserted.

Unchanged texts or NULL pointers are not re-drawn to avoid flickering, unchanged percentage values or '-1' are also ignored.

Example:

HLLJOB hJob;

hJob = LlJobOpen(0);

if (LlPrintWithBoxStart(hJob, LL_PROJECT_LABEL, "test.lbl", LL_PRINT_NORMAL,
      LL_BOXTYPE_NORMALMETER, hWnd, "print") == 0)
{
   LlPrintSetBoxText(hJob, "starting...", 0);
   <... etc...>
   LlPrintEnd(hJob);
   LlPrintSetBoxText(hJob, "done", 100);
}
else
   MessageBox(NULL, "error", "List & Label", MB_OK);
LlJobClose(hJob);

See also:

LlPrintWithBoxStart, LlPrintUpdateBox, LlPrint