Pick File Dialog Action
Event Function: FileDialog
The Pick File Dialog action will launch the standard Windows File Open dialog to help you find a file path.
Using the Events tab
| Under | Enter | Example |
|---|---|---|
|
Run Skip Condition |
If desired, enter skip conditions for the event. When the "Run Skip Condition" is evaluated to be true, the action is not performed. |
|
|
File Cell |
Cell number to populate with chosen path |
cellno(c1) |
|
Load Dialog |
Yes for Load Dialog, No for Save Dialog |
"Yes" Yes |
|
Base Path |
Starting path |
prgdir() + "styles" |
|
Types |
File type drop down information |
"CaseView Files (*.cvw)|*.cvw|All Files (*.*)|*.*||" |
|
Default Extension |
Default extension to add to chosen file |
"lib" |
Syntax (if entering it in the Equation bar)
ACTION("FileDialog",expr1,expr2,expr3,expr4,expr5)
Where
expr1 = entry under File Cell
expr2 = entry under Load Dialog (Y/N)
expr3 = entry under Base Path
expr4 = entry under Types
expr5 = entry under Default Extension
How the example will appear in the Equation bar
ACTION("FileDialog", cellno(c1), "Yes", prgdir() + "styles", "CaseView Files (*.cvw)|*.cvw|All Files (*.*)|*.*||", "lib")
Notes
- This event allows the designer to give the end user a nice interface for specifying a path to a file. It does not create a file, nor does it save the current CaseView document to the file chosen. A designer could use this event to allow the user to pick a style sheet or a knowledge library for another operation. For example, if the CaseView document had a load style sheet button, this event could be used to allow the user to pick the style sheet to load and then to actually load the style sheet.
- The Types field must end with a double bar (||) inside the quotes as in the table presented earlier. Without this command CaseView is not given a clear indication that it should stop looking for available file types and may display unexpected text in the resulting window's Files of Type selection.
