Syntax:

INT LlSelectFileDlgTitleEx (HLLJOB hJob, HWND hWnd, LPCTSTR pszTitle, UINT nObjType, LPTSTR pszBuffer, UINT nBufLen, LPVOID pReserved);

Task:

Opens a file selection dialog with an optionally integrated preview window.

Parameter:

hJob: List & Label job handle

hWnd: Window handle of the calling program

pszTitle: Title for the dialog

nObjType:

Combined with LL_FILE_ALSONEW if a file name for a new (not yet existing) pro­ject can be entered.

pszBuffer, nBufSize: Buffer for the file name with file extension. Must be initialized with a file name or an empty string.

pReserved: Reserved, set to NULL or empty ("").

Return Value:

Error code

Hints:

Important for Visual Basic (and some other languages as well), if the OCX control is not used: the buffer must be allocated and initialized by an 0-terminated string.

Advantages compared to a normal CommonDialog: display of the project description, a preview sketch, the language consistency within List & Label and the adaptation of the dialog design.

See chapter Important Remarks on the Function Parameters of DLLs concerning the buffer return value.

Example:

char szFilename[260 + 1];
INT nRet;

nRet = LlSelectFileDlgTitleEx(hJob, hWnd, "Report" , LL_PROJECT_LIST,
         szFilename, sizeof(szFilename));
if (nRet == OK)
{
   <then do what you have to do>
}

See also:

LL_OPTION_OFNDIALOG_NOPLACESBAR, LL_OPTIONSTR_..._PRJDESCR