RecentChooser

---

Object Hierarchy:

Description:

Content:

Properties:

• public RecentFilter filter { set; get; }
  The RecentFilter object to be used when displaying the recently used resources.
• public int limit { set; get; }
  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 RecentChooser by setting this property.
• public bool local_only { set; get; }
  Whether this RecentChooser should display only local (file:) resources.
• public RecentManager recent_manager { construct set; }
  The RecentManager instance used by the RecentChooser to display the list of recently used resources.
• public bool select_multiple { set; get; }
  Allow the user to select multiple resources.
• public bool show_icons { set; get; }
  Whether this RecentChooser should display an icon near the item.
• public bool show_not_found { set; get; }
  Whether this RecentChooser 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).
• public bool show_private { set; get; }
• public bool show_tips { set; get; }
  Whether this RecentChooser should display a tooltip containing the full path of the recently used resources.
• public RecentSortType sort_type { set; get; }
  Sorting order to be used when displaying the recently used resources.

Static methods:

• public static Quark error_quark ()

Methods:

• public abstract void add_filter (RecentFilter filter)
  Adds filter to the list of RecentFilter objects held by chooser.
• public weak RecentInfo get_current_item ()
  Gets the RecentInfo currently selected by chooser.
• public abstract unowned string get_current_uri ()
  Gets the URI currently selected by chooser.
• public weak RecentFilter get_filter ()
  Gets the RecentFilter object currently used by chooser to affect the display of the recently used resources.
• public abstract List<RecentInfo> get_items ()
  Gets the list of recently used resources in form of RecentInfo objects.
• public int get_limit ()
  Gets the number of items returned by get_items and get_uris.
• public bool get_local_only ()
  Gets whether only local resources should be shown in the recently used resources selector. See set_local_only
• public abstract weak RecentManager get_recent_manager ()
• public bool get_select_multiple ()
  Gets whether chooser can select multiple items.
• public bool get_show_icons ()
  Retrieves whether chooser should show an icon near the resource.
• public bool get_show_not_found ()
  Retrieves whether chooser should show the recently used resources that were not found.
• public bool get_show_private ()
  Returns whether chooser should display recently used resources registered as private.
• public bool get_show_tips ()
  Gets whether chooser should display tooltips containing the full path of a recently user resource.
• public RecentSortType get_sort_type ()
  Gets the value set by set_sort_type.
• public unowned string get_uris (size_t length)
  Gets the URI of the recently used resources.
• public abstract SList<weak RecentFilter> list_filters ()
  Gets the RecentFilter objects held by chooser .
• public abstract void remove_filter (RecentFilter filter)
  Removes filter from the list of RecentFilter objects held by chooser.
• public abstract void select_all ()
  Selects all the items inside chooser, if the chooser supports multiple selection.
• public abstract bool select_uri (string uri) throws Error
  Selects uri inside chooser.
• public abstract bool set_current_uri (string uri) throws Error
  Sets uri as the current URI for chooser.
• public void set_filter (RecentFilter filter)
  Sets filter as the current RecentFilter object used by chooser to affect the displayed recently used resources.
• public void set_limit (int limit)
  Sets the number of items that should be returned by get_items and get_uris.
• public void set_local_only (bool 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.
• public void set_select_multiple (bool select_multiple)
  Sets whether chooser can select multiple items.
• public void set_show_icons (bool show_icons)
  Sets whether chooser should show an icon near the resource when displaying it.
• public void set_show_not_found (bool show_not_found)
  Sets whether chooser should display the recently used resources that it didn't find. This only applies to local resources.
• public void set_show_private (bool show_private)
  Whether to show recently used resources marked registered as private.
• public void set_show_tips (bool show_tips)
  Sets whether to show a tooltips containing the full path of each recently used resource in a RecentChooser widget.
• public abstract void set_sort_func (owned RecentSortFunc sort_func)
  Sets the comparison function used when sorting to be sort_func. If the chooser has the sort type set to CUSTOM then the chooser will sort using this function.
• public void set_sort_type (RecentSortType sort_type)
  Changes the sorting order of the recently used resources list displayed by chooser.
• public abstract void unselect_all ()
  Unselects all the items inside chooser.
• public abstract void unselect_uri (string uri)
  Unselects uri inside chooser.

Signals:

• public void item_activated ()
  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.
• public void selection_changed ()
  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.