gtkFileChooserSetFilename {RGtk2} | R Documentation |
Sets filename
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.
gtkFileChooserSetFilename(object, filename)
|
[GtkFileChooser ] a GtkFileChooser |
|
[char] the filename to set as current |
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 (chooser, default_folder_for_saving); gtk_file_chooser_set_current_name (chooser, "Untitled document"); } else { / * the user edited an existing document * / gtk_file_chooser_set_filename (chooser, existing_filename); }
Since 2.4
[logical] TRUE
if both the folder could be changed and the file was
selected successfully, FALSE
otherwise.
Derived by RGtkGen from GTK+ documentation