| 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