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