Method

GtkPlacesSidebarget_nth_bookmark

since: 3.10

Declaration [src]

GFile*
gtk_places_sidebar_get_nth_bookmark (
  GtkPlacesSidebar* sidebar,
  gint n
)

Description [src]

This function queries the bookmarks added by the user to the places sidebar, and returns one of them. This function is used by GtkFileChooser to implement the “Alt-1”, “Alt-2”, etc. shortcuts, which activate the cooresponding bookmark.

Available since: 3.10

Parameters

n

Type: gint

Index of the bookmark to query.

Return value

Type: GFile

The bookmark specified by the index n, or NULL if no such index exist. Note that the indices start at 0, even though the file chooser starts them with the keyboard shortcut “Alt-1”.

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

The return value can be NULL.