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