LL_NTFY_DESIGNERPRINTJOB

Task:

Via callback LL_NTFY_DESIGNERPRINTJOB List & Label informs you about the task that has to be performed. This callback will always be called up in the context of the designer thread (this is the thread, from which LlDefineLayout() was called).

Parameters:

The callback parameter is a pointer to a scLlDesignerPrintJob structure:

_nUserParam: value you set LL_OPTION_DESIGNERPREVIEWPARAMETER to or assigned LL_OPTION_DESIGNEREXPORTPARAMETER to.

_pszProjectName: Name of the project to print. This parameter is only valid with the command "START", otherwise NULL.

_pszOriginalProjectFileName: Name of the original project. This parameter is only valid with the command "START", otherwise NULL. It is necessary, so that relative paths and the function ProjectPath$() are correctly evaluated by List & Label.

_nPages: Maximum number of pages to be output. This will have to be passed after print start via

LlPrintSetOption(hJob,LL_PRNOPT_LASTPAGE,_nPages)

to the print job. If _nPages has the value "0", this means, that the print should not be limited.

_nFunction: Operations to be performed. There are four different operations: Start, Break, Finalize and Status query.

As there are two groups of operation (EXPORT and PREVIEW), this gives 8 constants:

LL_DESIGNERPRINTCALLBACK_PREVIEW_START 
LL_DESIGNERPRINTCALLBACK_PREVIEW_ABORT 
LL_DESIGNERPRINTCALLBACK_PREVIEW_FINALIZE
LL_DESIGNERPRINTCALLBACK_PREVIEW_QUEST_JOBSTATE
LL_DESIGNERPRINTCALLBACK_EXPORT_START
LL_DESIGNERPRINTCALLBACK_EXPORT_ABORT
LL_DESIGNERPRINTCALLBACK_EXPORT_FINALIZE
LL_DESIGNERPRINTCALLBACK_EXPORT_QUEST_JOBSTATE

_hWnd: Window handle. The meaning of this structure member is described below.

_hEvent: Event handle, needed for communication and synchronization of your application with List & Label.

_pszExportFormat: Preselected export format (required in Ribbon mode only), see chapter Direct Print and Export From the Designer.

_bWithoutDialog: Print/export without dialog (required in Ribbon mode only), see chapter Direct Print and Export From the Designer.

Return Value:

Return LL_DESIGNERPRINTTHREAD_STATE_RUNNING, if your thread is working otherwise LL_DESIGNERPRINTTHREAD_STATE_STOPPED.

Hints:

See chapter Direct Print and Export From the Designer.