choose.files {base} | R Documentation |
Use a Windows file dialog to choose a list of zero or more files interactively.
choose.files(default = "", caption = "Select files",
multi = TRUE, filters = Filters, index = nrow(Filters))
Filters
default |
which filename to show initially |
caption |
the caption on the file selection dialog |
multi |
whether to allow multiple files to be selected |
filters |
a matrix of filename filters (see Details) |
index |
which row of filters to use by default |
Unlike file.choose
, this function will always
attempt to return a character vector
giving a list of files. If the user cancels the dialog, then
zero files are returned, whereas file.choose
would
signal an error.
Windows file dialog boxes include a list of “filters”, which allow
the file selection to be limited to files of specific types.
The filters
argument to choose.files
allows the list
of filters to be set. It should be an n
by 2
character
matrix. The first column gives, for each filter, the description the
user will see, while the second column gives the mask(s) to select
those files. If more than one mask is used, separate them by
semicolons, with no spaces. The index
argument chooses which
filter will be used initially.
Filters
is a matrix giving the descriptions and masks for
the file types that R knows about. Print it to see typical formats
for filter specifications. The examples below show how particular
filters may be selected.
If you would like to display files in a particular directory,
give a fully qualified file mask (e.g. 'c:\\*.*'
)
in the default
argument. If a directory is not given, the
dialog will start in the current directory the first time, and
“remember” the last directory on subsequent invocations.
A character vector giving zero or more file paths.
file.choose
if (interactive())
choose.files(filters = Filters[c("zip", "All"),])