Back to Seed Clases

Gtk

Classes

Interfaces

Structs

Unions

Enums

Interface Gtk.RecentChooser

Import line:	Gtk = imports.gi.Gtk;
GIR File:	Gtk-3.0.gir
C documentation:	GtkRecentChooser
Interface :	RecentChooser
Implementations:	Gtk.RecentAction, Gtk.RecentChooserDialog, Gtk.RecentChooserMenu, Gtk.RecentChooserWidget

GtkRecentChooser 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 GtkRecentChooserWidget,
GtkRecentChooserDialog and GtkRecentChooserMenu.
Recently used files are supported since GTK+ 2.10.

Properties
Properties		Defined By
	filter : Gtk.RecentFilter The GtkRecentFilter object to be used when displaying the recently used resources. The GtkRecentFilter object to be used when displaying the recently used resources.	Gtk.RecentChooser
	limit : gint32 The maximum number of recently used resources to be displayed, or -1 to display all items. The maximum number of recently used resources to be displayed, or -1 to display all items. By default, the override that limit on a particular instance of GtkRecentChooser by setting this property.	Gtk.RecentChooser
	local_only : gboolean Whether this GtkRecentChooser should display only local (file:) resources. Whether this GtkRecentChooser should display only local (file:) resources.	Gtk.RecentChooser
	recent_manager : Gtk.RecentManager The GtkRecentManager instance used by the GtkRecentChooser to display the list of recently used resources. The GtkRecentManager instance used by the GtkRecentChooser to display the list of recently used resources.	Gtk.RecentChooser
	select_multiple : gboolean Allow the user to select multiple resources. Allow the user to select multiple resources.	Gtk.RecentChooser
	show_icons : gboolean Whether this GtkRecentChooser should display an icon near the item. Whether this GtkRecentChooser should display an icon near the item.	Gtk.RecentChooser
	show_not_found : gboolean Whether this GtkRecentChooser should display the recently used resources even if not present anymore. 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).	Gtk.RecentChooser
	show_private : gboolean	Gtk.RecentChooser
	show_tips : gboolean Whether this GtkRecentChooser should display a tooltip containing the full path of the recently used resources. Whether this GtkRecentChooser should display a tooltip containing the full path of the recently used resources.	Gtk.RecentChooser
	sort_type : Gtk.RecentSortType Sorting order to be used when displaying the recently used resources. Sorting order to be used when displaying the recently used resources.	Gtk.RecentChooser

Methods / Constructors
Method / Constructor		Defined By
	add_filter (RecentFilter *filter) : none Adds filter* to the list of GtkRecentFilter objects held by chooser. 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(). Parameters: Gtk.RecentFilter filter Required (not null) a GtkRecentFilter Returns: none	Gtk.RecentChooser
	get_current_item () : Gtk.RecentInfo Gets the GtkRecentInfo currently selected by chooser. Gets the GtkRecentInfo currently selected by chooser. when you have finished using it. Returns: Gtk.RecentInfo a GtkRecentInfo. Use gtk_recent_info_unref() when	Gtk.RecentChooser
	get_current_uri () : String Gets the URI currently selected by chooser. Gets the URI currently selected by chooser. Returns: String a newly allocated string holding a URI.	Gtk.RecentChooser
	get_filter () : Gtk.RecentFilter Gets the GtkRecentFilter object currently used by chooser to affect the display of the recently used resources. Gets the GtkRecentFilter object currently used by chooser to affect the display of the recently used resources. Returns: Gtk.RecentFilter a GtkRecentFilter object.	Gtk.RecentChooser
	get_items () : Array Gets the list of recently used resources in form of GtkRecentInfo objects. 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. 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(). Returns: Array A newly allocated	Gtk.RecentChooser
	get_limit () : gint32 Gets the number of items returned by gtk_recent_chooser_get_items() and gtk_recent_chooser_get_uris(). Gets the number of items returned by gtk_recent_chooser_get_items() and gtk_recent_chooser_get_uris(). returned. Returns: gint32 A positive integer, or -1 meaning that all items are	Gtk.RecentChooser
	get_local_only () : gboolean Gets whether only local resources should be shown in the recently used resources selector. Gets whether only local resources should be shown in the recently used resources selector. See gtk_recent_chooser_set_local_only() Returns: gboolean TRUE if only local resources should be shown.	Gtk.RecentChooser
	get_select_multiple () : gboolean Gets whether chooser can select multiple items. Gets whether chooser can select multiple items. Returns: gboolean TRUE if chooser can select more than one item.	Gtk.RecentChooser
	get_show_icons () : gboolean Retrieves whether chooser should show an icon near the resource. Retrieves whether chooser should show an icon near the resource. Returns: gboolean TRUE if the icons should be displayed, FALSE otherwise.	Gtk.RecentChooser
	get_show_not_found () : gboolean Retrieves whether chooser should show the recently used resources that were not found. Retrieves whether chooser should show the recently used resources that were not found. FALSE otheriwse. Returns: gboolean TRUE if the resources not found should be displayed, and	Gtk.RecentChooser
	get_show_private () : gboolean Returns whether chooser should display recently used resources registered as private. Returns whether chooser should display recently used resources registered as private. FALSE otherwise. Returns: gboolean TRUE if the recent chooser should show private items,	Gtk.RecentChooser
	get_show_tips () : gboolean Gets whether chooser should display tooltips containing the full path of a recently user resource. Gets whether chooser should display tooltips containing the full path of a recently user resource. FALSE otherwise. Returns: gboolean TRUE if the recent chooser should show tooltips,	Gtk.RecentChooser
	get_sort_type () : Gtk.RecentSortType Gets the value set by gtk_recent_chooser_set_sort_type(). Gets the value set by gtk_recent_chooser_set_sort_type(). Returns: Gtk.RecentSortType the sorting order of the chooser.	Gtk.RecentChooser
	get_uris (Object *out_values) : Array Gets the URI of the recently used resources. 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. Parameters: Object out_values guint32 length Returns: Array	Gtk.RecentChooser
	list_filters () : Array Gets the GtkRecentFilter objects held by chooser. Gets the GtkRecentFilter objects held by chooser. of GtkRecentFilter objects. You should just free the returned list using g_slist_free(). Returns: Array A singly linked list	Gtk.RecentChooser
	remove_filter (RecentFilter *filter) : none Removes filter* from the list of GtkRecentFilter objects held by chooser. Removes filter from the list of GtkRecentFilter objects held by chooser. Parameters: Gtk.RecentFilter filter Required (not null) a GtkRecentFilter Returns: none	Gtk.RecentChooser
	select_all () : none Selects all the items inside chooser, if the chooser supports multiple selection. Selects all the items inside chooser, if the chooser supports multiple selection. Returns: none	Gtk.RecentChooser
	select_uri (String *uri) : gboolean Selects uri* inside chooser. Selects uri inside chooser. Parameters: String uri Required (not null) a URI Returns: gboolean TRUE if uri was found.	Gtk.RecentChooser
	set_current_uri (String *uri) : gboolean Sets uri* as the current URI for chooser. Sets uri as the current URI for chooser. Parameters: String uri Required (not null) a URI Returns: gboolean TRUE if the URI was found.	Gtk.RecentChooser
	set_filter (RecentFilter *filter) : none Sets filter* as the current GtkRecentFilter object used by chooser to affect the displayed recently used resources. Sets filter as the current GtkRecentFilter object used by chooser to affect the displayed recently used resources. Parameters: Gtk.RecentFilter filter Required (not null) a GtkRecentFilter Returns: none	Gtk.RecentChooser
	set_limit (gint32 *limit) : none Sets the number of items that should be returned by gtk_recent_chooser_get_items() and gtk_recent_chooser_get_uris(). Sets the number of items that should be returned by gtk_recent_chooser_get_items() and gtk_recent_chooser_get_uris(). Parameters: gint32 limit* Required (not null) a positive integer, or -1 for all items Returns: none	Gtk.RecentChooser
	set_local_only (gboolean *local_only) : none Sets whether only local resources, that is resources using the file:// URI scheme, should be shown in the recently used resources selector. Sets whether only local resources, that is resources using the file:// URI scheme, should be shown in the recently used resources selector. If to be accessible through the operating system native file system. Parameters: gboolean local_only* Required (not null) TRUE if only local files can be shown Returns: none	Gtk.RecentChooser
	set_select_multiple (gboolean *select_multiple) : none Sets whether chooser* can select multiple items. Sets whether chooser can select multiple items. Parameters: gboolean select_multiple Required (not null) TRUE if chooser can select more than one item Returns: none	Gtk.RecentChooser
	set_show_icons (gboolean *show_icons) : none Sets whether chooser* should show an icon near the resource when displaying it. Sets whether chooser should show an icon near the resource when displaying it. Parameters: gboolean show_icons Required (not null) whether to show an icon near the resource Returns: none	Gtk.RecentChooser
	set_show_not_found (gboolean *show_not_found) : none Sets whether chooser* should display the recently used resources that it didn't find. Sets whether chooser should display the recently used resources that it didn't find. This only applies to local resources. Parameters: gboolean show_not_found Required (not null) whether to show the local items we didn't find Returns: none	Gtk.RecentChooser
	set_show_private (gboolean *show_private) : none Whether to show recently used resources marked registered as private. Whether to show recently used resources marked registered as private. Parameters: gboolean show_private* Required (not null) TRUE to show private items, FALSE otherwise Returns: none	Gtk.RecentChooser
	set_show_tips (gboolean *show_tips) : none Sets whether to show a tooltips containing the full path of each recently used resource in a GtkRecentChooser* widget. Sets whether to show a tooltips containing the full path of each recently used resource in a GtkRecentChooser widget. Parameters: gboolean show_tips Required (not null) TRUE if tooltips should be shown Returns: none	Gtk.RecentChooser
	set_sort_func (Function *sort_func, void *sort_data, Function data_destroy) : none Sets the comparison function used when sorting to be sort_func. 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 item comes before the second, zero if the two items are equal and a negative integer if the first item comes after the second. Parameters: Function (RecentInfo a, RecentInfo b, void* *user_data) : none Required (not null) the comparison function void sort_data user data to pass to sort_func, or NULL Function (void* *data) : none destroy notifier for sort_data, or NULL* Returns: none	Gtk.RecentChooser
	set_sort_type (RecentSortType *sort_type) : none Changes the sorting order of the recently used resources list displayed by Changes the sorting order of the recently used resources list displayed by Parameters: Gtk.RecentSortType sort_type* Required (not null) sort order that the chooser should use Returns: none	Gtk.RecentChooser
	unselect_all () : none Unselects all the items inside chooser. Unselects all the items inside chooser. Returns: none	Gtk.RecentChooser
	unselect_uri (String *uri) : none Unselects uri* inside chooser. Unselects uri inside chooser. Parameters: String uri Required (not null) a URI Returns: none	Gtk.RecentChooser

Events - usage syntax: this.signals.EVENTNAME.connect( Function )
Event		Defined By
	item_activated (RecentChooser *self) : none This signal is emitted when the user "activates" a recent item in the recent chooser. 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. Parameters: Gtk.RecentChooser self* Returns: {none}	Gtk.RecentChooser
	selection_changed (RecentChooser *self) : none This signal is emitted when there is a change in the set of selected recently used resources. 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. Parameters: Gtk.RecentChooser self* Returns: {none}	Gtk.RecentChooser