EXECUTE OPEN DIALOG
This command displayes a standard open file dialog and returns 1 if the user selected one or more files or 0 if the user cancelled the dialog. The selected file(s) can then be retrieved with OPEN DIALOG FILENAME() or OPEN DIALOG FILES().
A filter string consists of a description and a mask separated by a vertical bar (|) character. Do not include spaces around the vertical bar. For example:
Text Files (*.txt)|*.txt
Multiple filters should be separated by vertical bars. For example:
"Text Files (*.txt)|*.txt|All files (*.*)|*.*
You can pre-select the filter which will be initially shown in the dialog with the Index parameter. Set Index to 1 to choose the first file type in the list as the default, or set Index to 2 to choose the second file type as the default, and so forth. If the value of FilterIndex is out or range, the first file type listed in Filter is the default.
To include multiple masks in a single filter, separate the masks with semicolons. For example
Configuration Files|*.ini;*.cfg
An empty filter string will display all files.
ARGUMENTS:
optional:
* Window Handle = Handle to the parent window
* Title = Title of the dialogs (defaults to "Open" if an empty string is passed)
* Dir = The initial directory (defaults to the current directory if an empty string is passed)
* Filter = The filter string (see remarks above)
* Filename = The default file displayed in the file name field of the dialog
optional:
* Index = The filter index (see remarks above)
RETURNS:
Returns 1 if the user selected one or more files or 0 if the user cancelled the dialog.
SYNTAX
Return Integer=EXECUTE OPEN DIALOG([Window Handle,] Title,Dir,Filter,Filename [,Index])
RELATED INFO
View Dialogs Index
View STYX Index
View STYX Main File