gtk.recent_chooser

Module for [RecentChooser] interface

iface RecentChooser RecentChooserGidBuilderImpl

Types 2

#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.

Methods

GType _getGType()

gtk.recent_filter.RecentFilter filter() @propertyGet `filter` property. Returns: The #GtkRecentFilter object to be used when displaying the recently used resources.

void filter(gtk.recent_filter.RecentFilter propval) @propertySet `filter` property. Params: propval = The #GtkRecentFilter object to be used when displaying the recently used resources.

int limit() @propertyGet `limit` property. Returns: The maximum number of recently used resources to be displayed, or -1 to display all items.

void limit(int propval) @propertySet `limit` property. Params: propval = The maximum number of recently used resources to be displayed, or -1 to display all items.

bool localOnly() @propertyGet `localOnly` property. Returns: Whether this #GtkRecentChooser should display only local (file:) resources.

void localOnly(bool propval) @propertySet `localOnly` property. Params: propval = Whether this #GtkRecentChooser should display only local (file:) resources.

bool selectMultiple() @propertyGet `selectMultiple` property. Returns: Allow the user to select multiple resources.

void selectMultiple(bool propval) @propertySet `selectMultiple` property. Params: propval = Allow the user to select multiple resources.

bool showIcons() @propertyGet `showIcons` property. Returns: Whether this #GtkRecentChooser should display an icon near the item.

void showIcons(bool propval) @propertySet `showIcons` property. Params: propval = Whether this #GtkRecentChooser should display an icon near the item.

bool showNotFound() @propertyGet `showNotFound` property. Returns: Whether this #GtkRecentChooser should display the recently used resources even if not present anymore. Setting this to false will perform a potentially expensi...

void showNotFound(bool propval) @propertySet `showNotFound` property. Params: propval = Whether this #GtkRecentChooser should display the recently used resources even if not present anymore. Setting this to false will perform a potentiall...

bool showPrivate() @property

void showPrivate(bool propval) @property

bool showTips() @propertyGet `showTips` property. Returns: Whether this #GtkRecentChooser should display a tooltip containing the full path of the recently used resources.

void showTips(bool propval) @propertySet `showTips` property. Params: propval = Whether this #GtkRecentChooser should display a tooltip containing the full path of the recently used resources.

gtk.types.RecentSortType sortType() @propertyGet `sortType` property. Returns: Sorting order to be used when displaying the recently used resources.

void sortType(gtk.types.RecentSortType propval) @propertySet `sortType` property. Params: propval = Sorting order to be used when displaying the recently used resources.

void addFilter(gtk.recent_filter.RecentFilter filter)Adds filter to the list of #GtkRecentFilter objects held by chooser.

gtk.recent_info.RecentInfo getCurrentItem()Gets the #GtkRecentInfo currently selected by chooser. Returns: a #GtkRecentInfo. Use [gtk.recent_info.RecentInfo.unref] when when you have finished using it.

string getCurrentUri()Gets the URI currently selected by chooser. Returns: a newly allocated string holding a URI.

gtk.recent_filter.RecentFilter getFilter()Gets the #GtkRecentFilter object currently used by chooser to affect the display of the recently used resources. Returns: a #GtkRecentFilter object.

gtk.recent_info.RecentInfo[] getItems()Gets the list of recently used resources in form of #GtkRecentInfo objects.

int getLimit()Gets the number of items returned by [gtk.recentchooser.RecentChooser.getItems] and [gtk.recentchooser.RecentChooser.getUris]. Returns: A positive integer, or -1 meaning that all items are returned.

bool getLocalOnly()Gets whether only local resources should be shown in the recently used resources selector. See [gtk.recent_chooser.RecentChooser.setLocalOnly] Returns: true if only local resources should be shown.

bool getSelectMultiple()Gets whether chooser can select multiple items. Returns: true if chooser can select more than one item.

bool getShowIcons()Retrieves whether chooser should show an icon near the resource. Returns: true if the icons should be displayed, false otherwise.

bool getShowNotFound()Retrieves whether chooser should show the recently used resources that were not found. Returns: true if the resources not found should be displayed, and false otheriwse.

bool getShowPrivate()Returns whether chooser should display recently used resources registered as private. Returns: true if the recent chooser should show private items, false otherwise.

bool getShowTips()Gets whether chooser should display tooltips containing the full path of a recently user resource. Returns: true if the recent chooser should show tooltips, false otherwise.

gtk.types.RecentSortType getSortType()Gets the value set by [gtk.recent_chooser.RecentChooser.setSortType]. Returns: the sorting order of the chooser.

string[] getUris()Gets the URI of the recently used resources.

gtk.recent_filter.RecentFilter[] listFilters()Gets the #GtkRecentFilter objects held by chooser. Returns: A singly linked list of #GtkRecentFilter objects. You should just free the returned list using [glib.slist.SList.free].

void removeFilter(gtk.recent_filter.RecentFilter filter)Removes filter from the list of #GtkRecentFilter objects held by chooser.

void selectAll()Selects all the items inside chooser, if the chooser supports multiple selection.

bool selectUri(string uri)Selects uri inside chooser.

bool setCurrentUri(string uri)Sets uri as the current URI for chooser.

void setFilter(gtk.recent_filter.RecentFilter filter = null)Sets filter as the current #GtkRecentFilter object used by chooser to affect the displayed recently used resources.

void setLimit(int limit)Sets the number of items that should be returned by [gtk.recentchooser.RecentChooser.getItems] and [gtk.recentchooser.RecentChooser.getUris].

void setLocalOnly(bool localOnly)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 resou...

void setSelectMultiple(bool selectMultiple)Sets whether chooser can select multiple items.

void setShowIcons(bool showIcons)Sets whether chooser should show an icon near the resource when displaying it.

void setShowNotFound(bool showNotFound)Sets whether chooser should display the recently used resources that it didn’t find. This only applies to local resources.

void setShowPrivate(bool showPrivate)Whether to show recently used resources marked registered as private.

void setShowTips(bool showTips)Sets whether to show a tooltips containing the full path of each recently used resource in a #GtkRecentChooser widget.

void setSortFunc(gtk.types.RecentSortFunc sortFunc)Sets the comparison function used when sorting to be sortfunc. If the chooser has the sort type set to #GTKRECENTSORTCUSTOM then the chooser will sort using this function.

void setSortType(gtk.types.RecentSortType sortType)Changes the sorting order of the recently used resources list displayed by chooser.

void unselectAll()Unselects all the items inside chooser.

void unselectUri(string uri)Unselects uri inside chooser.

gulong connectItemActivated(T)(T callback, Flag!"After" after = No.After)Connect to `ItemActivated` signal.

gulong connectSelectionChanged(T)(T callback, Flag!"After" after = No.After)Connect to `SelectionChanged` signal.

interfaceRecentChooserGidBuilderImpl(T)

Methods

T filter(gtk.recent_filter.RecentFilter propval)Set `filter` property. Params: propval = The #GtkRecentFilter object to be used when displaying the recently used resources. Returns: Builder instance for fluent chaining

T limit(int propval)Set `limit` property. Params: propval = The maximum number of recently used resources to be displayed, or -1 to display all items. Returns: Builder instance for fluent chaining

T localOnly(bool propval)Set `localOnly` property. Params: propval = Whether this #GtkRecentChooser should display only local (file:) resources. Returns: Builder instance for fluent chaining

T recentManager(gtk.recent_manager.RecentManager propval)Set `recentManager` property. Params: propval = The #GtkRecentManager instance used by the #GtkRecentChooser to display the list of recently used resources. Returns: Builder instance for fluent cha...

T selectMultiple(bool propval)Set `selectMultiple` property. Params: propval = Allow the user to select multiple resources. Returns: Builder instance for fluent chaining

T showIcons(bool propval)Set `showIcons` property. Params: propval = Whether this #GtkRecentChooser should display an icon near the item. Returns: Builder instance for fluent chaining

T showNotFound(bool propval)Set `showNotFound` property. Params: propval = Whether this #GtkRecentChooser should display the recently used resources even if not present anymore. Setting this to false will perform a potentiall...

T showPrivate(bool propval)

T showTips(bool propval)Set `showTips` property. Params: propval = Whether this #GtkRecentChooser should display a tooltip containing the full path of the recently used resources. Returns: Builder instance for fluent chai...

T sortType(gtk.types.RecentSortType propval)Set `sortType` property. Params: propval = Sorting order to be used when displaying the recently used resources. Returns: Builder instance for fluent chaining