Description Usage Arguments Details Value Author(s)
Sets the file referred to by uri
as the current file for the file chooser,
by changing to the URI's parent folder and actually selecting the URI in the
list. If the chooser
is GTK_FILE_CHOOSER_ACTION_SAVE
mode, the URI's base
name will also appear in the dialog's file name entry.
1 | gtkFileChooserSetUri(object, uri)
|
|
a |
|
the URI to set as current |
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:
1 2 3 4 5 6 7 8 9 10 11 | 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
[logical] TRUE
if both the folder could be changed and the URI was
selected successfully, FALSE
otherwise.
Derived by RGtkGen from GTK+ documentation
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.