GtkFileSelection {RGtk2} | R Documentation |
Prompt the user for a file or directory name
gtkFileSelectionNew(title = NULL, show = TRUE)
gtkFileSelectionSetFilename(object, filename)
gtkFileSelectionGetFilename(object)
gtkFileSelectionComplete(object, pattern)
gtkFileSelectionShowFileopButtons(object)
gtkFileSelectionHideFileopButtons(object)
gtkFileSelectionGetSelections(object)
gtkFileSelectionSetSelectMultiple(object, select.multiple)
gtkFileSelectionGetSelectMultiple(object)
gtkFileSelection(title = NULL, show = TRUE)
GObject +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkWindow +----GtkDialog +----GtkFileSelection
GtkFileSelection implements AtkImplementorIface.
GtkFileSelection
should be used to retrieve file or directory names from
the user. It will create a new dialog window containing a directory list,
and a file list corresponding to the current working directory. The filesystem
can be navigated using the directory list or the drop-down history menu.
Alternatively, the TAB key can be used to navigate using filename
completion - common in text based editors such as emacs and jed.
File selection dialogs are created with a call to gtkFileSelectionNew
.
The default filename can be set using gtkFileSelectionSetFilename
and the selected filename retrieved using gtkFileSelectionGetFilename
.
Use gtkFileSelectionComplete
to display files and directories
that match a given pattern. This can be used for example, to show only
*.txt files, or only files beginning with gtk*.
Simple file operations; create directory, delete file, and rename file, are available from buttons at the top of the dialog. These can be hidden using gtkFileSelectionHideFileopButtons
and shown again using gtkFileSelectionShowFileopButtons
.
# Getting a filename from a user # Note how much easier GtkFileChooser is to use store_filename <- function(widget, file_selector) { selected_filename <- file_selector$getFilename(); print(paste("Selected filename:", selected_filename)) } create_file_selection <- function() { # Create the selector file_selector <- gtkFileSelection("Please select a file for editing.", show = F) gSignalConnect(file_selector[["ok_button"]], "clicked", store_filename, file_selector) # Ensure that the dialog box is destroyed when the user clicks a button. gSignalConnect(file_selector[["ok_button"]], "clicked", gtkWidgetDestroy, file_selector, user.data.first = T) gSignalConnect(file_selector[["cancel_button"]], "clicked", gtkWidgetDestroy, file_selector, user.data.first = T) # Display that dialog file_selector$show() }
GtkFileSelection
GtkFileSelection
struct contains the following GtkWidget
fields:
*fileop_dialog; | the dialog box used to display the GtkFileSelection . It can be customized by adding/removing widgets from it using the standard GtkDialog functions. |
*ok_button, *cancel_button; | the two main buttons that signals should be connected to in order to perform an action when the user hits either OK or Cancel. |
*history_pulldown; | the GtkOptionMenu used to create the drop-down directory history. |
*fileop_c_dir, *fileop_del_file, *fileop_ren_file; | the buttons that appear at the top of the file selection dialog. These "operation buttons" can be hidden and redisplayed with gtkFileSelectionHideFileopButtons and gtkFileSelectionShowFileopButtons respectively. |
gtkFileSelection
is the equivalent of gtkFileSelectionNew
.
filename
[character : Read / Write]The currently selected filename. Default value: NULL
select-multiple
[logical : Read / Write]Whether to allow multiple files to be selected. Default value: FALSE
show-fileops
[logical : Read / Write]Whether buttons for creating/manipulating files should be displayed. Default value: FALSE
Derived by RGtkGen from GTK+ documentation
http://developer.gnome.org/doc/API/2.0/gtk/GtkFileSelection.html