gtkFileChooserSetFile {RGtk2} | R Documentation |
Sets file
as the current filename for the file chooser, by changing
to the file's parent folder and actually selecting the file in list. If
the chooser
is in GTK_FILE_CHOOSER_ACTION_SAVE
mode, the file's base name
will also appear in the dialog's file name entry.
gtkFileChooserSetFile(object, file, .errwarn = TRUE)
|
|
|
the |
.errwarn |
Whether to issue a warning on error or fail silently |
If the file name isn't in the current folder of chooser
, then the current
folder of chooser
will be changed to the folder containing filename
. This
is equivalent to a sequence of gtkFileChooserUnselectAll
followed by
gtkFileChooserSelectFilename
.
Note that the file must exist, or nothing will be done except for the directory change.
If you are implementing a File/Save As... dialog, you should use this function if you already have a file name to which the user may save; for example, when the user opens an existing file and then does File/Save As... on it. If you don't have a file name already – for example, if the user just created a new file and is saving it for the first time, do not call this function. Instead, use something similar to this:
if (document_is_new) { /* the user just created a new document */ gtk_file_chooser_set_current_folder_file (chooser, default_file_for_saving); gtk_file_chooser_set_current_name (chooser, "Untitled document"); } else { /* the user edited an existing document */ gtk_file_chooser_set_file (chooser, existing_file); }Since 2.14
A list containing the following elements:
retval |
[logical] |
|
location to store the error, or |
Derived by RGtkGen from GTK+ documentation