RecentChooserWidget

GtkRecentChooserWidget is a widget suitable for selecting recently used files. It is the main building block of a GtkRecentChooserDialog. Most applications will only need to use the latter; you can use GtkRecentChooserWidget as part of a larger window if you have special needs.

Note that GtkRecentChooserWidget does not have any methods of its own. Instead, you should use the functions that work on a GtkRecentChooser.

Recently used files are supported since GTK+ 2.10.

class RecentChooserWidget : Box , RecentChooserIF {

protected

GtkRecentChooserWidget* gtkRecentChooserWidget;

GtkRecentChooserWidget* getRecentChooserWidgetStruct();

void* getStruct();

this(GtkRecentChooserWidget* gtkRecentChooserWidget);

void setStruct(GObject* obj);

mixin RecentChooserT!(GtkRecentChooserWidget) ;

this();

this(RecentManager manager);

}

Constructors

this this(GtkRecentChooserWidget* gtkRecentChooserWidget): Sets our main struct and passes it to the parent class
this this(): Creates a new GtkRecentChooserWidget object. This is an embeddable widget used to access the recently used resources list. Since 2.10
this this(RecentManager manager): Creates a new GtkRecentChooserWidget with a specified recent manager. This is useful if you have implemented your own recent manager, or if you have a customized instance of a GtkRecentManager object. Since 2.10

Members

Functions

getRecentChooserWidgetStruct GtkRecentChooserWidget* getRecentChooserWidgetStruct(): Undocumented in source. Be warned that the author may not have intended to support it.
getStruct void* getStruct(): the main Gtk struct as a void*
setStruct void setStruct(GObject* obj): Undocumented in source. Be warned that the author may not have intended to support it.

Mixins

__anonymous mixin RecentChooserT!(GtkRecentChooserWidget): Undocumented in source.

Variables

gtkRecentChooserWidget GtkRecentChooserWidget* gtkRecentChooserWidget;: the main Gtk struct

Inherited Members

From Box

gtkBox GtkBox* gtkBox;: the main Gtk struct
getBoxStruct GtkBox* getBoxStruct(): Undocumented in source. Be warned that the author may not have intended to support it.
getStruct void* getStruct(): the main Gtk struct as a void*
setStruct void setStruct(GObject* obj): Undocumented in source. Be warned that the author may not have intended to support it.
__anonymous mixin OrientableT!(GtkBox): Undocumented in source.
packStart void packStart(Widget child, int expand, int fill, uint padding): Adds child to box, packed with reference to the start of box. The child is packed after any other child packed with reference to the start of box.
packEnd void packEnd(Widget child, int expand, int fill, uint padding): Adds child to box, packed with reference to the end of box. The child is packed after (away from end of) any other child packed with reference to the end of box.
getHomogeneous int getHomogeneous(): Returns whether the box is homogeneous (all children are the same size). See gtk_box_set_homogeneous().
setHomogeneous void setHomogeneous(int homogeneous): Sets the "homogeneous" property of box, controlling whether or not all children of box are given equal space in the box.
getSpacing int getSpacing(): Gets the value set by gtk_box_set_spacing().
setSpacing void setSpacing(int spacing): Sets the "spacing" property of box, which is the number of pixels to place between children of box.
reorderChild void reorderChild(Widget child, int position): Moves child to a new position in the list of box children. The list is the children field of GtkBox, and contains both widgets packed GTK_PACK_START as well as widgets packed GTK_PACK_END, in the order that these widgets were added to box. A widget's position in the box children list determines where the widget is packed into box. A child widget at some position in the list will be packed just after all other widgets of the same packing type that appear earlier in the list.
queryChildPacking void queryChildPacking(Widget child, int expand, int fill, uint padding, GtkPackType packType): Obtains information about how child is packed into box.
setChildPacking void setChildPacking(Widget child, int expand, int fill, uint padding, GtkPackType packType): Sets the way child is packed into box.
getBaselinePosition GtkBaselinePosition getBaselinePosition(): Gets the value set by gtk_box_set_baseline_position().
setBaselinePosition void setBaselinePosition(GtkBaselinePosition position): Sets the baseline position of a box. This affects only horizontal boxes with at least one baseline aligned child. If there is more vertical space availible than requested, and the baseline is not allocated by the parent then position is used to allocate the baseline wrt the extra space available.

From RecentChooserIF

getRecentChooserTStruct GtkRecentChooser* getRecentChooserTStruct(): Undocumented in source.
getStruct void* getStruct(): the main Gtk struct as a void*
onItemActivatedListeners void delegate(RecentChooserIF)[] onItemActivatedListeners [@property getter]
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
onSelectionChangedListeners void delegate(RecentChooserIF)[] onSelectionChangedListeners [@property getter]: Undocumented in source.
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
setShowPrivate void setShowPrivate(int showPrivate): Whether to show recently used resources marked registered as private. Since 2.10
getShowPrivate int getShowPrivate(): Returns whether chooser should display recently used resources registered as private. 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
getShowNotFound int getShowNotFound(): Retrieves whether chooser should show the recently used resources that were not found. Since 2.10
setShowIcons void setShowIcons(int showIcons): Sets whether chooser should show an icon near the resource when displaying it. Since 2.10
getShowIcons int getShowIcons(): Retrieves whether chooser should show an icon near the resource. Since 2.10
setSelectMultiple void setSelectMultiple(int selectMultiple): Sets whether chooser can select multiple items. Since 2.10
getSelectMultiple int getSelectMultiple(): Gets whether chooser can select multiple items. 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
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
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
getLimit int getLimit(): Gets the number of items returned by gtk_recent_chooser_get_items() and gtk_recent_chooser_get_uris(). 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
getShowTips int getShowTips(): Gets whether chooser should display tooltips containing the full path of a recently user resource. Since 2.10
setSortType void setSortType(GtkRecentSortType sortType): Changes the sorting order of the recently used resources list displayed by chooser. Since 2.10
getSortType GtkRecentSortType getSortType(): Gets the value set by gtk_recent_chooser_set_sort_type(). 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
setCurrentUri int setCurrentUri(string uri): Sets uri as the current URI for chooser. Since 2.10
getCurrentUri string getCurrentUri(): Gets the URI currently selected by chooser. Since 2.10
getCurrentItem RecentInfo getCurrentItem(): Gets the GtkRecentInfo currently selected by chooser. Since 2.10
selectUri int selectUri(string uri): Selects uri inside chooser. Since 2.10
unselectUri void unselectUri(string uri): Unselects uri inside chooser. Since 2.10
selectAll void selectAll(): Selects all the items inside chooser, if the chooser supports multiple selection. Since 2.10
unselectAll void unselectAll(): Unselects all the items inside chooser. 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
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
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
removeFilter void removeFilter(RecentFilter filter): Removes filter from the list of GtkRecentFilter objects held by chooser. Since 2.10
listFilters ListSG listFilters(): Gets the GtkRecentFilter objects held by 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
getFilter RecentFilter getFilter(): Gets the GtkRecentFilter object currently used by chooser to affect the display of the recently used resources. Since 2.10