If the URI isn't in the current folder of chooser, then the current folder
of chooser will be changed to the folder containing uri. This is equivalent
to a sequence of gtkFileChooserUnselectAll followed by
gtkFileChooserSelectUri.
Note that the URI 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_uri (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_uri (chooser, existing_uri);
}
Since 2.4