You are here: Features > Action Events > Pick file dialog

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.

Cookie Notice