• Reference Guide


select_multiple_file_names(init, filter, extension, flags)
select_multiple_file_names(init, filter, extension, flags, title)
The function displays the standard operating system dialog for choosing file names of multiple files.


The initial folder and/or file name. If the string specified ends with a backslash (\), it is considered a folder name.
The list of permitted file types. The type of the parameter is Seq(String[2]), i.e. a list of pairs of strings. In every pair, the first member contains a file name mask, while the other contains a human-readable description. If it is necessary to include more than one mask in one string, the masks are separated by a semicolon. Example: {{"*.jpg; *.jpe; *.jpeg", "JPEG Images"}, {"*.gif", "GIF Images"}}.
The file extension to be used when the user does not specify one. The extension is specified without the dot (e.g. "txt").
An Int parameter containing combination of file name selection constants.
A String parameter. If specified, it determines the window title of the dialog. If omitted, a standard one is used (“Open” or “Save As”).

Return Value

The function returns a sequence of File_name values (Seq(File_name), File_name is a named type String) containing the full paths to the selected files. If the user cancels the dialog with the Cancel button, an empty sequence is returned.

See Also