Scilab Function
Last update : 27/2/2006
tk_MFgetfile - dialog to get one or more file paths with multiple filters
Calling Sequence
-
filepath=tk_getfiles([title='string'][,multip='1'][,path='starting path'][,ini='initial file name'][,foo='additional tk options'])
-
filepath=tk_getfiles([multip="1"])
-
filepath=tk_getfiles(file_mask[,title="string"][,multip="1"])
-
filepath=tk_getfiles(file_mask,path[,title="string"])
-
filepath=tk_getfiles(file_mask,path[,title="string"][,multip="1"])
-
filepath=tk_getfiles([file_mask[,path[,title[,multip[,ini[,foo]]]]]])
Parameters
-
file_mask
: a character string which gives the file mask to use for file selection.
file_mask
is written with Unix convention. The default value is '*'.
format: "{{typename} {extension extension ...}} {{typename} {extnsion extension ...}} ..."
-
typename
is discriptive name e.g. SciLab Files
-
extension
one or more extension e.g. .sci .sce
-
path
: a character string which gives the initial directory used for
file search. By default tk_getfile uses the previously selected
directory.
-
multip
: Optional argument which allows to select more than one file at
once in the tk_getfile window. If given, it must be the string "1".
Otherwise, or if not given, this argument defaults to "0" i.e. only
one file can be selected in the dialog.
-
title
: an optional character string which appears as title of the dialoge, default is "save".
-
ini
: an optional character string which could be used to give a default name.
-
foo
: an optional character string which could be used to path additional Tcl/Tk options to the "tk_getSaveFile" Tcl/Tk function, see Tcl/Tk manual for this informations.
-
filepath
: is the user selected file path, or an array of file pathes, if user answers "Open" or the " " string if user answers "Cancel"
Description
Creates a dialog window for multiple file selection, includes extension filters.
Examples
tk_MFgetfile()
tk_MFgetfile("*.sci","SCI/macros/xdess")
tk_MFgetfile(title="Choose a file name")
tk_MFgetfile(title="Choose many file names at once",multip="1")
tk_MFgetfile(multip="1")
tk_MFgetfile("{{SciLab} {.sci .sce}} {""Text"" .txt} {{All Files} *}",title="Multiple Selection with Multiple Filters",multip="1",path="SCI/macros/xdess")
See Also
xgetfile
,
tk_getdir
,
tk_getfile
,
tk_MFsavefile
,
file
,
fileinfo
,