Method

GtkFileChooseradd_shortcut_folder

since: 2.4

Declaration [src]

gboolean
gtk_file_chooser_add_shortcut_folder (
  GtkFileChooser* chooser,
  const char* folder,
  GError** error
)

Description [src]

Adds a folder to be displayed with the shortcut folders in a file chooser. Note that shortcut folders do not get saved, as they are provided by the application. For example, you can use this to add a “/usr/share/mydrawprogram/Clipart” folder to the volume list.

Available since: 2.4

Parameters

folder

Type: const char*

Filename of the folder to add.

The data is owned by the caller of the method.
The value is a platform-native string, using the preferred OS encoding on Unix and UTF-8 on Windows.
error

Type: GError **

The return location for a recoverable error.

The argument can be NULL.
If the return location is not NULL, then you must initialize it to a NULL GError*.
The argument will be left initialized to NULL by the method if there are no errors.
In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.

Return value

Type: gboolean

TRUE if the folder could be added successfully, FALSE otherwise. In the latter case, the error will be set as appropriate.