Method

GtkFileChooserget_current_folder_uri

since: 2.4

Declaration [src]

gchar*
gtk_file_chooser_get_current_folder_uri (
  GtkFileChooser* chooser
)

Description [src]

Gets the current folder of chooser as an URI. See gtk_file_chooser_set_current_folder_uri().

Note that this is the folder that the file chooser is currently displaying (e.g. “file:///home/username/Documents”), which is not the same as the currently-selected folder if the chooser is in GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER mode (e.g. “file:///home/username/Documents/selected-folder/”. To get the currently-selected folder in that mode, use gtk_file_chooser_get_uri() as the usual way to get the selection.

Available since: 2.4

Return value

Type: gchar*

The URI for the current folder. Free with g_free(). This function will also return NULL if the file chooser was unable to load the last folder that was requested from it; for example, as would be for calling gtk_file_chooser_set_current_folder_uri() on a nonexistent folder.

The caller of the method takes ownership of the returned data, and is responsible for freeing it.

The return value can be NULL.

The value is a NUL terminated UTF-8 string.