svDialogs (version 0.9-57)

dlgOpen: A select file(s) to open dialog box

Description

Allows to easily select one or more existings files.

Usage

dlgOpen(default, title, multiple = FALSE, filters = dlgFilters["All", ],
    …, gui = .GUI)
dlgFilters
## These should not be called directly
# S3 method for gui
dlgOpen(default, title, multiple = FALSE, filters = dlgFilters["All", ],
    …, gui = .GUI)
# S3 method for textCLI
dlgOpen(default, title, multiple = FALSE, filters = dlgFilters["All", ],
    …, gui = .GUI)
# S3 method for nativeGUI
dlgOpen(default, title, multiple = FALSE, filters = dlgFilters["All", ],
    …, gui = .GUI)

Arguments

default

the default file to start with (use /dir/* or /dir/*.* to start in a given directory).

title

a title to display on top of the dialog box.

multiple

is a multiple selection of files allowed?

filters

a specification of file filters as a nx2 matrix, or a character string with even number of items. First items is the label, second one is the filter. See dlgFilters for examples. This is currently ignored on Mac OS X, since such kind of filter is defined differently there.

…

pass further arguments to methods.

gui

the 'gui' object concerned by this dialog box.

Value

The modified 'gui' object is returned invisibly. The choosen file(s), or an empty string if the cancel button was clicked is found in gui$res (see example).

See Also

dlgSave, dlgDir

Examples

# NOT RUN {
## Choose one R file
dlgOpen(title = "Select one R file", filters = dlgFilters[c("R", "All"), ])$res
## Choose several files
dlgOpen(multiple = TRUE)$res
# }