RecentChooser
Object Hierarchy:
Description:
RecentChooser is an interface that can be implemented by widgets displaying the list of recently used files.
In GTK+, the main objects that implement this interface are RecentChooserWidget , RecentChooserDialog and RecentChooserMenu.
Recently used files are supported since GTK+ 2.10.
All known implementing classes:
Namespace: Gtk
Package: gtk+-3.0
Content:
Properties:
- public RecentFilter filter { get; set; }
The RecentFilter object to be used when displaying the recently used resources.
- public int limit { get; set; }
The maximum number of recently used resources to be displayed, or -1 to display all items.
- public bool local_only { get; set; }
Whether this RecentChooser should display only local (file:) resources.
- public RecentManager recent_manager { construct; }
The RecentManager instance used by the RecentChooser to display the list of recently used resources.
- public bool select_multiple { get; set; }
Allow the user to select multiple resources.
- public bool show_icons { get; set; }
Whether this RecentChooser should display an icon near the item.
- public bool show_not_found { get; set; }
Whether this RecentChooser should display the recently used resources even if not present anymore.
- public bool show_private { get; set; }
- public bool show_tips { get; set; }
Whether this RecentChooser should display a tooltip containing the full path of the recently used resources.
- public RecentSortType sort_type { get; set; }
Sorting order to be used when displaying the recently used resources.
Methods:
- public abstract void add_filter (RecentFilter filter)
Adds
filter
to the list of RecentFilter objects held by this. - public RecentInfo get_current_item ()
Gets the RecentInfo currently selected by this.
- public abstract string get_current_uri ()
Gets the URI currently selected by this.
- public unowned RecentFilter get_filter ()
Gets the RecentFilter object currently used by this 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 ()
- public bool get_local_only ()
Gets whether only local resources should be shown in the recently used resources selector.
- public abstract unowned RecentManager get_recent_manager ()
- public bool get_select_multiple ()
Gets whether this can select multiple items.
- public bool get_show_icons ()
Retrieves whether this should show an icon near the resource.
- public bool get_show_not_found ()
Retrieves whether this should show the recently used resources that were not found.
- public bool get_show_private ()
Returns whether this should display recently used resources registered as private.
- public bool get_show_tips ()
Gets whether this 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 string[] get_uris ()
Gets the URI of the recently used resources.
- public abstract SList<unowned RecentFilter> list_filters ()
Gets the RecentFilter objects held by this.
- public abstract void remove_filter (RecentFilter filter)
Removes
filter
from the list of RecentFilter objects held by this. - public abstract void select_all ()
Selects all the items inside this, if the this supports multiple selection.
- public abstract bool select_uri (string uri) throws Error
Selects
uri
inside this. - public abstract bool set_current_uri (string uri) throws Error
Sets
uri
as the current URI for this . - public void set_filter (RecentFilter? filter)
Sets
filter
as the current RecentFilter object used by this to affect the displayed recently used resources. - public void set_limit (int limit)
- 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.
- public void set_select_multiple (bool select_multiple)
Sets whether this can select multiple items.
- public void set_show_icons (bool show_icons)
Sets whether this should show an icon near the resource when displaying it.
- public void set_show_not_found (bool show_not_found)
Sets whether this should display the recently used resources that it didn’t find.
- 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
. - public void set_sort_type (RecentSortType sort_type)
Changes the sorting order of the recently used resources list displayed by this.
- public abstract void unselect_all ()
Unselects all the items inside this.
- public abstract void unselect_uri (string uri)
Unselects
uri
inside this.
Signals:
- public virtual signal void item_activated ()
This signal is emitted when the user "activates" a recent item in the recent chooser.
- public virtual signal void selection_changed ()
This signal is emitted when there is a change in the set of selected recently used resources.
Inherited Members:
All known members inherited from class GLib.Object