LlDesignerFileOpen

Syntax:

INT LlDesignerFileOpen(HLLJOB hJob, LPCTSTR pszFileName, UINT nFlags);

Task:

Opens the specified project file when the Designer is open.

Parameter:

hJob: List & Label Job-Handle

pszFileName: Project file name including path and file extension

nFlags: Combination (ORed) of a flag from the following two groups at any one time:

Value

Meaning

LL_DESFILEOPEN_OPEN_EXISTING

File must already exist, otherwise an Error Code will be returned.

LL_DESFILEOPEN_CREATE_­ALWAYS

File will always be newly created. If file already exists, then file content will be deleted.

LL_DESFILEOPEN_CREATE_NEW

File will always be newly created if not already existing. If file already exists, an error code will be returned.

LL_DESFILEOPEN_OPEN_ALWAYS

If file exists, it will be opened, otherwise new file will be created.

LL_DESFILEOPEN_OPEN_IMPORT

Imports an existent file into an already opened project.

 

Value

Meaning

LL_DESFILEOPENFLAG_­SUPPRESS_SAVEDIALOG

The currently opened project will be automatically saved without user interaction before loading a new project.

LL_DESFILEOPENFLAG_­SUPPRESS_SAVE

The currently opened project will be closed automatically without being saved. All changes after the last save will therefore be lost!

LL_DESFILEOPENFLAG_DEFAULT

The currently opened project will be saved or closed as selected by the user – if necessary before the new project is loaded.

 

Return Value:

Error code

Hints:

The function can only be used within a designer event. Typical use is in connection with LlDesignerAddAction() in order to automate certain application workflows.

See also:

LlDesignerFileSave