Scilab Function
Last update : 29/9/2005

tk_getfile - dialog to get one or more file paths

### Calling Sequence

  `path=tk_getfile([title="string"])`
  `path=tk_getfile([multip="1"])`
  `path=tk_getfile(file_mask[,title="string"][,multip="1"])`
  `path=tk_getfile(file_mask,dir[,title="string"])`
  `path=tk_getfile(file_mask,dir[,title="string"][,multip="1"])`
  `path=tk_getfile(file_mask,dir,"string"[,"multip"])`

### 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 '*'.
- `dir`: a character string which gives the initial directory used for file search. By default tk_getfile uses the previously selected directory.
- `path`: is the user selected file path(s) if user answers "Ok" or the " " string if user answers "Cancel".
- `title="string"`: Optional argument which gives the title for the tk_getfile window.
- `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.

### Description

Creates a dialog window for file selection.

### Examples

    tk_getfile()
    tk_getfile("*.sci","SCI/macros/xdess")
    tk_getfile(title="Choose a file name")
    tk_getfile(title="Choose many file names at once",multip="1")
    tk_getfile(multip="1")

### See Also

`xgetfile`, `tk_getdir`, `file`, `fileinfo`,