RecentChooserIF

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.

interface RecentChooserIF {

GtkRecentChooser* getRecentChooserTStruct();

void* getStruct();

void delegate(RecentChooserIF)[] onItemActivatedListeners [@property getter];

void addOnItemActivated(void delegate(RecentChooserIF) dlg, ConnectFlags connectFlags);

void delegate(RecentChooserIF)[] onSelectionChangedListeners [@property getter];

void addOnSelectionChanged(void delegate(RecentChooserIF) dlg, ConnectFlags connectFlags);

void setShowPrivate(int showPrivate);

int getShowPrivate();

void setShowNotFound(int showNotFound);

int getShowNotFound();

void setShowIcons(int showIcons);

int getShowIcons();

void setSelectMultiple(int selectMultiple);

int getSelectMultiple();

void setLocalOnly(int localOnly);

int getLocalOnly();

void setLimit(int limit);

int getLimit();

void setShowTips(int showTips);

int getShowTips();

void setSortType(GtkRecentSortType sortType);

GtkRecentSortType getSortType();

void setSortFunc(GtkRecentSortFunc sortFunc, void* sortData, GDestroyNotify dataDestroy);

int setCurrentUri(string uri);

string getCurrentUri();

RecentInfo getCurrentItem();

int selectUri(string uri);

void unselectUri(string uri);

void selectAll();

void unselectAll();

ListG getItems();

string[] getUris();

void addFilter(RecentFilter filter);

void removeFilter(RecentFilter filter);

ListSG listFilters();

void setFilter(RecentFilter filter);

RecentFilter getFilter();

}

Members

Functions

addFilter void addFilter(RecentFilter 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
addOnItemActivated void addOnItemActivated(void delegate(RecentChooserIF) dlg, ConnectFlags connectFlags): 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. Since 2.10
addOnSelectionChanged void addOnSelectionChanged(void delegate(RecentChooserIF) dlg, ConnectFlags connectFlags): 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. Since 2.10 See Also GtkRecentManager, GtkRecentChooserDialog, GtkRecentChooserWidget, GtkRecentChooserMenu
getCurrentItem RecentInfo getCurrentItem(): Gets the GtkRecentInfo currently selected by chooser. Since 2.10
getCurrentUri string getCurrentUri(): Gets the URI currently selected by chooser. Since 2.10
getFilter RecentFilter getFilter(): Gets the GtkRecentFilter object currently used by chooser to affect the display of the recently used resources. Since 2.10
getItems ListG getItems(): 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. Since 2.10
getLimit int getLimit(): Gets the number of items returned by gtk_recent_chooser_get_items() and gtk_recent_chooser_get_uris(). Since 2.10
getLocalOnly int getLocalOnly(): Gets whether only local resources should be shown in the recently used resources selector. See gtk_recent_chooser_set_local_only() Since 2.10
getRecentChooserTStruct GtkRecentChooser* getRecentChooserTStruct(): Get the main Gtk struct
getSelectMultiple int getSelectMultiple(): Gets whether chooser can select multiple items. Since 2.10
getShowIcons int getShowIcons(): Retrieves whether chooser should show an icon near the resource. Since 2.10
getShowNotFound int getShowNotFound(): Retrieves whether chooser should show the recently used resources that were not found. Since 2.10
getShowPrivate int getShowPrivate(): Returns whether chooser should display recently used resources registered as private. Since 2.10
getShowTips int getShowTips(): Gets whether chooser should display tooltips containing the full path of a recently user resource. Since 2.10
getSortType GtkRecentSortType getSortType(): Gets the value set by gtk_recent_chooser_set_sort_type(). Since 2.10
getStruct void* getStruct(): the main Gtk struct as a void*
getUris string[] getUris(): 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. Since 2.10
listFilters ListSG listFilters(): Gets the GtkRecentFilter objects held by chooser. Since 2.10
removeFilter void removeFilter(RecentFilter filter): Removes filter from the list of GtkRecentFilter objects held by chooser. Since 2.10
selectAll void selectAll(): Selects all the items inside chooser, if the chooser supports multiple selection. Since 2.10
selectUri int selectUri(string uri): Selects uri inside chooser. Since 2.10
setCurrentUri int setCurrentUri(string uri): Sets uri as the current URI for chooser. Since 2.10
setFilter void setFilter(RecentFilter filter): Sets filter as the current GtkRecentFilter object used by chooser to affect the displayed recently used resources. Since 2.10
setLimit void setLimit(int 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
setLocalOnly void setLocalOnly(int 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 resources are guaranteed to be accessible through the operating system native file system. Since 2.10
setSelectMultiple void setSelectMultiple(int selectMultiple): Sets whether chooser can select multiple items. Since 2.10
setShowIcons void setShowIcons(int showIcons): Sets whether chooser should show an icon near the resource when displaying it. Since 2.10
setShowNotFound void setShowNotFound(int showNotFound): Sets whether chooser should display the recently used resources that it didn't find. This only applies to local resources. Since 2.10
setShowPrivate void setShowPrivate(int showPrivate): Whether to show recently used resources marked registered as private. Since 2.10
setShowTips void setShowTips(int showTips): Sets whether to show a tooltips containing the full path of each recently used resource in a GtkRecentChooser widget. Since 2.10
setSortFunc void setSortFunc(GtkRecentSortFunc sortFunc, void* sortData, GDestroyNotify dataDestroy): 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. Since 2.10
setSortType void setSortType(GtkRecentSortType sortType): Changes the sorting order of the recently used resources list displayed by chooser. Since 2.10
unselectAll void unselectAll(): Unselects all the items inside chooser. Since 2.10
unselectUri void unselectUri(string uri): Unselects uri inside chooser. Since 2.10

Properties

onItemActivatedListeners void delegate(RecentChooserIF)[] onItemActivatedListeners [@property getter]
onSelectionChangedListeners void delegate(RecentChooserIF)[] onSelectionChangedListeners [@property getter]: Undocumented in source.

RecentChooserIF

Members

Functions

Properties

Meta

Source