| Top |  |  |  |  | 
| GtkRecentFilter * | filter | Read / Write | 
| int | limit | Read / Write | 
| gboolean | local-only | Read / Write | 
| GtkRecentManager * | recent-manager | Write / Construct Only | 
| gboolean | select-multiple | Read / Write | 
| gboolean | show-icons | Read / Write | 
| gboolean | show-not-found | Read / Write | 
| gboolean | show-private | Read / Write | 
| gboolean | show-tips | Read / Write | 
| GtkRecentSortType | sort-type | Read / Write | 
| GtkRecentChooser | |
| struct | GtkRecentChooserIface | 
| #define | GTK_RECENT_CHOOSER_ERROR | 
| enum | GtkRecentChooserError | 
| enum | GtkRecentSortType | 
GtkRecentChooser is implemented by GtkRecentAction, GtkRecentChooserDialog, GtkRecentChooserMenu and GtkRecentChooserWidget.
void gtk_recent_chooser_set_show_private (GtkRecentChooser *chooser,gboolean show_private);
Whether to show recently used resources marked registered as private.
Since: 2.10
gboolean
gtk_recent_chooser_get_show_private (GtkRecentChooser *chooser);
Returns whether chooser
 should display recently used resources
registered as private.
Since: 2.10
void gtk_recent_chooser_set_show_not_found (GtkRecentChooser *chooser,gboolean show_not_found);
Sets whether chooser
 should display the recently used resources that
it didn't find.  This only applies to local resources.
Since: 2.10
gboolean
gtk_recent_chooser_get_show_not_found (GtkRecentChooser *chooser);
Retrieves whether chooser
 should show the recently used resources that
were not found.
Since: 2.10
void gtk_recent_chooser_set_show_icons (GtkRecentChooser *chooser,gboolean show_icons);
Sets whether chooser
 should show an icon near the resource when
displaying it.
Since: 2.10
gboolean
gtk_recent_chooser_get_show_icons (GtkRecentChooser *chooser);
Retrieves whether chooser
 should show an icon near the resource.
Since: 2.10
void gtk_recent_chooser_set_select_multiple (GtkRecentChooser *chooser,gboolean select_multiple);
Sets whether chooser
 can select multiple items.
Since: 2.10
gboolean
gtk_recent_chooser_get_select_multiple
                               (GtkRecentChooser *chooser);
Gets whether chooser
 can select multiple items.
Since: 2.10
void gtk_recent_chooser_set_local_only (GtkRecentChooser *chooser,gboolean local_only);
Sets whether only local resources, that is resources using the file:// URI
scheme, should be shown in the recently used resources selector.  If
local_only
 is TRUE (the default) then the shown resources are guaranteed
to be accessible through the operating system native file system.
Since: 2.10
gboolean
gtk_recent_chooser_get_local_only (GtkRecentChooser *chooser);
Gets whether only local resources should be shown in the recently used
resources selector.  See gtk_recent_chooser_set_local_only()
Since: 2.10
void gtk_recent_chooser_set_limit (GtkRecentChooser *chooser,gint limit);
Sets the number of items that should be returned by
gtk_recent_chooser_get_items() and gtk_recent_chooser_get_uris().
Since: 2.10
gint
gtk_recent_chooser_get_limit (GtkRecentChooser *chooser);
Gets the number of items returned by gtk_recent_chooser_get_items()
and gtk_recent_chooser_get_uris().
Since: 2.10
void gtk_recent_chooser_set_show_tips (GtkRecentChooser *chooser,gboolean show_tips);
Sets whether to show a tooltips containing the full path of each recently used resource in a GtkRecentChooser widget.
Since: 2.10
gboolean
gtk_recent_chooser_get_show_tips (GtkRecentChooser *chooser);
Gets whether chooser
 should display tooltips containing the full path
of a recently user resource.
Since: 2.10
void gtk_recent_chooser_set_show_numbers (GtkRecentChooser *chooser,gboolean show_numbers);
gtk_recent_chooser_set_show_numbers has been deprecated since version 2.12 and should not be used in newly-written code.
Use gtk_recent_chooser_menu_set_show_numbers() instead.
Whether to show recently used resources prepended by a unique number.
Since: 2.10
gboolean
gtk_recent_chooser_get_show_numbers (GtkRecentChooser *chooser);
gtk_recent_chooser_get_show_numbers has been deprecated since version 2.12 and should not be used in newly-written code.
use gtk_recent_chooser_menu_get_show_numbers() instead.
Returns whether chooser
 should display recently used resources
prepended by a unique number.
Since: 2.10
void gtk_recent_chooser_set_sort_type (GtkRecentChooser *chooser,GtkRecentSortType sort_type);
Changes the sorting order of the recently used resources list displayed by
chooser
.
Since: 2.10
GtkRecentSortType
gtk_recent_chooser_get_sort_type (GtkRecentChooser *chooser);
Gets the value set by gtk_recent_chooser_set_sort_type().
Since: 2.10
gint (*GtkRecentSortFunc) (GtkRecentInfo *a,GtkRecentInfo *b,gpointer user_data);
void gtk_recent_chooser_set_sort_func (GtkRecentChooser *chooser,GtkRecentSortFunc sort_func,gpointer sort_data,GDestroyNotify data_destroy);
Sets the comparison function used when sorting to be sort_func
.  If
the chooser
 has the sort type set to GTK_RECENT_SORT_CUSTOM then
the chooser will sort using this function.
To the comparison function will be passed two GtkRecentInfo structs and
sort_data
;  sort_func
 should return a positive integer if the first
item comes before the second, zero if the two items are equal and
a negative integer if the first item comes after the second.
| chooser | ||
| sort_func | the comparison function | |
| sort_data | user data to pass to  | [allow-none] | 
| data_destroy | destroy notifier for  | [allow-none] | 
Since: 2.10
gboolean gtk_recent_chooser_set_current_uri (GtkRecentChooser *chooser,const gchar *uri,GError **error);
Sets uri
 as the current URI for chooser
.
Since: 2.10
gchar *
gtk_recent_chooser_get_current_uri (GtkRecentChooser *chooser);
Gets the URI currently selected by chooser
.
Since: 2.10
GtkRecentInfo *
gtk_recent_chooser_get_current_item (GtkRecentChooser *chooser);
Gets the GtkRecentInfo currently selected by chooser
.
Since: 2.10
gboolean gtk_recent_chooser_select_uri (GtkRecentChooser *chooser,const gchar *uri,GError **error);
Selects uri
 inside chooser
.
Since: 2.10
void gtk_recent_chooser_unselect_uri (GtkRecentChooser *chooser,const gchar *uri);
Unselects uri
 inside chooser
.
Since: 2.10
void
gtk_recent_chooser_select_all (GtkRecentChooser *chooser);
Selects all the items inside chooser
, if the chooser
 supports
multiple selection.
Since: 2.10
void
gtk_recent_chooser_unselect_all (GtkRecentChooser *chooser);
Unselects all the items inside chooser
.
Since: 2.10
GList *
gtk_recent_chooser_get_items (GtkRecentChooser *chooser);
Gets the list of recently used resources in form of GtkRecentInfo objects.
The return value of this function is affected by the "sort-type" and
"limit" properties of chooser
.
A newly allocated
list of GtkRecentInfo objects.  You should
use gtk_recent_info_unref() on every item of the list, and then free
the list itself using g_list_free(). 
[element-type GtkRecentInfo][transfer full]
Since: 2.10
gchar ** gtk_recent_chooser_get_uris (GtkRecentChooser *chooser,gsize *length);
Gets the URI of the recently used resources.
The return value of this function is affected by the "sort-type" and "limit"
properties of chooser
.
Since the returned array is NULL terminated, length
 may be NULL.
A newly allocated, NULL-terminated array of strings. Use
g_strfreev() to free it. 
[array length=length zero-terminated=1][transfer full]
Since: 2.10
void gtk_recent_chooser_add_filter (GtkRecentChooser *chooser,GtkRecentFilter *filter);
Adds filter
 to the list of GtkRecentFilter objects held by chooser
.
If no previous filter objects were defined, this function will call
gtk_recent_chooser_set_filter().
Since: 2.10
void gtk_recent_chooser_remove_filter (GtkRecentChooser *chooser,GtkRecentFilter *filter);
Removes filter
 from the list of GtkRecentFilter objects held by chooser
.
Since: 2.10
GSList *
gtk_recent_chooser_list_filters (GtkRecentChooser *chooser);
Gets the GtkRecentFilter objects held by chooser
.
A singly linked list
of GtkRecentFilter objects.  You
should just free the returned list using g_slist_free(). 
[element-type GtkRecentFilter][transfer container]
Since: 2.10
void gtk_recent_chooser_set_filter (GtkRecentChooser *chooser,GtkRecentFilter *filter);
Sets filter
 as the current GtkRecentFilter object used by chooser
to affect the displayed recently used resources.
Since: 2.10
GtkRecentFilter *
gtk_recent_chooser_get_filter (GtkRecentChooser *chooser);
Gets the GtkRecentFilter object currently used by chooser
 to affect
the display of the recently used resources.
Since: 2.10
struct GtkRecentChooserIface {
  GTypeInterface base_iface;
  /*
   * Methods
   */
  gboolean          (* set_current_uri)    (GtkRecentChooser  *chooser,
  					    const gchar       *uri,
  					    GError           **error);
  gchar *           (* get_current_uri)    (GtkRecentChooser  *chooser);
  gboolean          (* select_uri)         (GtkRecentChooser  *chooser,
  					    const gchar       *uri,
  					    GError           **error);
  void              (* unselect_uri)       (GtkRecentChooser  *chooser,
                                            const gchar       *uri);
  void              (* select_all)         (GtkRecentChooser  *chooser);
  void              (* unselect_all)       (GtkRecentChooser  *chooser);
  GList *           (* get_items)          (GtkRecentChooser  *chooser);
  GtkRecentManager *(* get_recent_manager) (GtkRecentChooser  *chooser);
  void              (* add_filter)         (GtkRecentChooser  *chooser,
  					    GtkRecentFilter   *filter);
  void              (* remove_filter)      (GtkRecentChooser  *chooser,
  					    GtkRecentFilter   *filter);
  GSList *          (* list_filters)       (GtkRecentChooser  *chooser);
  void              (* set_sort_func)      (GtkRecentChooser  *chooser,
  					    GtkRecentSortFunc  sort_func,
  					    gpointer           data,
  					    GDestroyNotify     destroy);
  /*
   * Signals
   */
  void		    (* item_activated)     (GtkRecentChooser  *chooser);
  void		    (* selection_changed)  (GtkRecentChooser  *chooser);
};
Used to specify the sorting method to be applyed to the recently used resource list.
“filter” property“filter” GtkRecentFilter *
The GtkRecentFilter object to be used when displaying the recently used resources.
Owner: GtkRecentChooser
Flags: Read / Write
Since: 2.10
“limit” property  “limit”                    int
The maximum number of recently used resources to be displayed, or -1 to display all items. By default, the GtkSetting:gtk-recent-files-limit setting is respected: you can override that limit on a particular instance of GtkRecentChooser by setting this property.
Owner: GtkRecentChooser
Flags: Read / Write
Allowed values: >= -1
Default value: -1
Since: 2.10
“local-only” property  “local-only”               gboolean
Whether this GtkRecentChooser should display only local (file:) resources.
Owner: GtkRecentChooser
Flags: Read / Write
Default value: TRUE
Since: 2.10
“recent-manager” property“recent-manager” GtkRecentManager *
The GtkRecentManager instance used by the GtkRecentChooser to display the list of recently used resources.
Owner: GtkRecentChooser
Flags: Write / Construct Only
Since: 2.10
“select-multiple” property  “select-multiple”          gboolean
Allow the user to select multiple resources.
Owner: GtkRecentChooser
Flags: Read / Write
Default value: FALSE
Since: 2.10
“show-icons” property  “show-icons”               gboolean
Whether this GtkRecentChooser should display an icon near the item.
Owner: GtkRecentChooser
Flags: Read / Write
Default value: TRUE
Since: 2.10
“show-not-found” property  “show-not-found”           gboolean
Whether this GtkRecentChooser should display the recently used resources
even if not present anymore. Setting this to FALSE will perform a
potentially expensive check on every local resource (every remote
resource will always be displayed).
Owner: GtkRecentChooser
Flags: Read / Write
Default value: TRUE
Since: 2.10
“show-private” property  “show-private”             gboolean
Whether the private items should be displayed.
Owner: GtkRecentChooser
Flags: Read / Write
Default value: FALSE
“show-tips” property  “show-tips”                gboolean
Whether this GtkRecentChooser should display a tooltip containing the full path of the recently used resources.
Owner: GtkRecentChooser
Flags: Read / Write
Default value: FALSE
Since: 2.10
“sort-type” property“sort-type” GtkRecentSortType
Sorting order to be used when displaying the recently used resources.
Owner: GtkRecentChooser
Flags: Read / Write
Default value: GTK_RECENT_SORT_NONE
Since: 2.10
“item-activated” signalvoid user_function (GtkRecentChooser *chooser, gpointer user_data)
This signal is emitted when the user "activates" a recent item in the recent chooser. This can happen by double-clicking on an item in the recently used resources list, or by pressing
Enter.| chooser | the object which received the signal | |
| user_data | user data set when the signal handler was connected. | 
Flags: Run Last
Since: 2.10
“selection-changed” signalvoid user_function (GtkRecentChooser *chooser, gpointer user_data)
This signal is emitted when there is a change in the set of selected recently used resources. This can happen when a user modifies the selection with the mouse or the keyboard, or when explicitely calling functions to change the selection.
| chooser | the object which received the signal | |
| user_data | user data set when the signal handler was connected. | 
Flags: Run Last
Since: 2.10