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.

Constructors

this
this(void* ptr, Flag!"Take" take)
this
this()

Creates a new #GtkRecentChooserWidget object. This is an embeddable widget used to access the recently used resources list.

Members

Functions

self
RecentChooserWidget self()

Returns this, for use in with statements.

Properties

_gType
GType _gType [@property getter]

Static functions

_getGType
GType _getGType()
builder
RecentChooserWidgetGidBuilder builder()

Get builder for gtk.recent_chooser_widget.RecentChooserWidget

newForManager
gtk.recent_chooser_widget.RecentChooserWidget newForManager(gtk.recent_manager.RecentManager manager)

Creates a new #GtkRecentChooserWidget with a specified recent manager.

Mixed In Members

From mixin RecentChooserT!()

filter
gtk.recent_filter.RecentFilter filter [@property getter]

Get filter property.

filter
gtk.recent_filter.RecentFilter filter [@property setter]

Set filter property.

limit
int limit [@property getter]

Get limit property.

limit
int limit [@property setter]

Set limit property.

localOnly
bool localOnly [@property getter]

Get localOnly property.

localOnly
bool localOnly [@property setter]

Set localOnly property.

selectMultiple
bool selectMultiple [@property getter]

Get selectMultiple property.

selectMultiple
bool selectMultiple [@property setter]

Set selectMultiple property.

showIcons
bool showIcons [@property getter]

Get showIcons property.

showIcons
bool showIcons [@property setter]

Set showIcons property.

showNotFound
bool showNotFound [@property getter]

Get showNotFound property.

showNotFound
bool showNotFound [@property setter]

Set showNotFound property.

showPrivate
bool showPrivate [@property getter]
showPrivate
bool showPrivate [@property setter]
showTips
bool showTips [@property getter]

Get showTips property.

showTips
bool showTips [@property setter]

Set showTips property.

sortType
gtk.types.RecentSortType sortType [@property getter]

Get sortType property.

sortType
gtk.types.RecentSortType sortType [@property setter]

Set sortType property.

addFilter
void addFilter(gtk.recent_filter.RecentFilter filter)

Adds filter to the list of #GtkRecentFilter objects held by chooser.

getCurrentItem
gtk.recent_info.RecentInfo getCurrentItem()

Gets the #GtkRecentInfo currently selected by chooser.

getCurrentUri
string getCurrentUri()

Gets the URI currently selected by chooser.

getFilter
gtk.recent_filter.RecentFilter getFilter()

Gets the #GtkRecentFilter object currently used by chooser to affect the display of the recently used resources.

getItems
gtk.recent_info.RecentInfo[] getItems()

Gets the list of recently used resources in form of #GtkRecentInfo objects.

getLimit
int getLimit()

Gets the number of items returned by gtk.recent_chooser.RecentChooser.getItems and gtk.recent_chooser.RecentChooser.getUris.

getLocalOnly
bool getLocalOnly()

Gets whether only local resources should be shown in the recently used resources selector. See gtk.recent_chooser.RecentChooser.setLocalOnly

getSelectMultiple
bool getSelectMultiple()

Gets whether chooser can select multiple items.

getShowIcons
bool getShowIcons()

Retrieves whether chooser should show an icon near the resource.

getShowNotFound
bool getShowNotFound()

Retrieves whether chooser should show the recently used resources that were not found.

getShowPrivate
bool getShowPrivate()

Returns whether chooser should display recently used resources registered as private.

getShowTips
bool getShowTips()

Gets whether chooser should display tooltips containing the full path of a recently user resource.

getSortType
gtk.types.RecentSortType getSortType()

Gets the value set by gtk.recent_chooser.RecentChooser.setSortType.

getUris
string[] getUris()

Gets the URI of the recently used resources.

listFilters
gtk.recent_filter.RecentFilter[] listFilters()

Gets the #GtkRecentFilter objects held by chooser.

removeFilter
void removeFilter(gtk.recent_filter.RecentFilter filter)

Removes filter from the list of #GtkRecentFilter objects held by chooser.

selectAll
void selectAll()

Selects all the items inside chooser, if the chooser supports multiple selection.

selectUri
bool selectUri(string uri)

Selects uri inside chooser.

setCurrentUri
bool setCurrentUri(string uri)

Sets uri as the current URI for chooser.

setFilter
void setFilter(gtk.recent_filter.RecentFilter filter)

Sets filter as the current #GtkRecentFilter object used by chooser to affect the displayed recently used resources.

setLimit
void setLimit(int limit)

Sets the number of items that should be returned by gtk.recent_chooser.RecentChooser.getItems and gtk.recent_chooser.RecentChooser.getUris.

setLocalOnly
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 resources are guaranteed to be accessible through the operating system native file system.

setSelectMultiple
void setSelectMultiple(bool selectMultiple)

Sets whether chooser can select multiple items.

setShowIcons
void setShowIcons(bool showIcons)

Sets whether chooser should show an icon near the resource when displaying it.

setShowNotFound
void setShowNotFound(bool showNotFound)

Sets whether chooser should display the recently used resources that it didn’t find. This only applies to local resources.

setShowPrivate
void setShowPrivate(bool showPrivate)

Whether to show recently used resources marked registered as private.

setShowTips
void setShowTips(bool showTips)

Sets whether to show a tooltips containing the full path of each recently used resource in a #GtkRecentChooser widget.

setSortFunc
void setSortFunc(gtk.types.RecentSortFunc sortFunc)

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.

setSortType
void setSortType(gtk.types.RecentSortType sortType)

Changes the sorting order of the recently used resources list displayed by chooser.

unselectAll
void unselectAll()

Unselects all the items inside chooser.

unselectUri
void unselectUri(string uri)

Unselects uri inside chooser.

connectItemActivated
gulong connectItemActivated(T callback, Flag!"After" after)

Connect to ItemActivated signal.

connectSelectionChanged
gulong connectSelectionChanged(T callback, Flag!"After" after)

Connect to SelectionChanged signal.

Inherited Members

From Box

_getGType
GType _getGType()
_gType
GType _gType [@property getter]
self
Box self()

Returns this, for use in with statements.

builder
BoxGidBuilder builder()

Get builder for gtk.box.Box

baselinePosition
gtk.types.BaselinePosition baselinePosition [@property getter]
baselinePosition
gtk.types.BaselinePosition baselinePosition [@property setter]
homogeneous
bool homogeneous [@property getter]
homogeneous
bool homogeneous [@property setter]
spacing
int spacing [@property getter]
spacing
int spacing [@property setter]
getBaselinePosition
gtk.types.BaselinePosition getBaselinePosition()

Gets the value set by gtk.box.Box.setBaselinePosition.

getCenterWidget
gtk.widget.Widget getCenterWidget()

Retrieves the center widget of the box.

getHomogeneous
bool getHomogeneous()

Returns whether the box is homogeneous (all children are the same size). See gtk.box.Box.setHomogeneous.

getSpacing
int getSpacing()

Gets the value set by gtk.box.Box.setSpacing.

packEnd
void packEnd(gtk.widget.Widget child, bool expand, bool 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.

packStart
void packStart(gtk.widget.Widget child, bool expand, bool 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.

queryChildPacking
void queryChildPacking(gtk.widget.Widget child, bool expand, bool fill, uint padding, gtk.types.PackType packType)

Obtains information about how child is packed into box.

reorderChild
void reorderChild(gtk.widget.Widget child, int position)

Moves child to a new position in the list of box children. The list contains widgets packed #GTK_PACK_START as well as widgets packed #GTK_PACK_END, in the order that these widgets were added to box.

setBaselinePosition
void setBaselinePosition(gtk.types.BaselinePosition 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 available than requested, and the baseline is not allocated by the parent then position is used to allocate the baseline wrt the extra space available.

setCenterWidget
void setCenterWidget(gtk.widget.Widget widget)

Sets a center widget; that is a child widget that will be centered with respect to the full width of the box, even if the children at either side take up different amounts of space.

setChildPacking
void setChildPacking(gtk.widget.Widget child, bool expand, bool fill, uint padding, gtk.types.PackType packType)

Sets the way child is packed into box.

setHomogeneous
void setHomogeneous(bool homogeneous)

Sets the #GtkBox:homogeneous property of box, controlling whether or not all children of box are given equal space in the box.

setSpacing
void setSpacing(int spacing)

Sets the #GtkBox:spacing property of box, which is the number of pixels to place between children of box.

From RecentChooser

_getGType
GType _getGType()
filter
gtk.recent_filter.RecentFilter filter [@property getter]

Get filter property.

filter
gtk.recent_filter.RecentFilter filter [@property setter]

Set filter property.

limit
int limit [@property getter]

Get limit property.

limit
int limit [@property setter]

Set limit property.

localOnly
bool localOnly [@property getter]

Get localOnly property.

localOnly
bool localOnly [@property setter]

Set localOnly property.

selectMultiple
bool selectMultiple [@property getter]

Get selectMultiple property.

selectMultiple
bool selectMultiple [@property setter]

Set selectMultiple property.

showIcons
bool showIcons [@property getter]

Get showIcons property.

showIcons
bool showIcons [@property setter]

Set showIcons property.

showNotFound
bool showNotFound [@property getter]

Get showNotFound property.

showNotFound
bool showNotFound [@property setter]

Set showNotFound property.

showPrivate
bool showPrivate [@property getter]
showPrivate
bool showPrivate [@property setter]
showTips
bool showTips [@property getter]

Get showTips property.

showTips
bool showTips [@property setter]

Set showTips property.

sortType
gtk.types.RecentSortType sortType [@property getter]

Get sortType property.

sortType
gtk.types.RecentSortType sortType [@property setter]

Set sortType property.

addFilter
void addFilter(gtk.recent_filter.RecentFilter filter)

Adds filter to the list of #GtkRecentFilter objects held by chooser.

getCurrentItem
gtk.recent_info.RecentInfo getCurrentItem()

Gets the #GtkRecentInfo currently selected by chooser.

getCurrentUri
string getCurrentUri()

Gets the URI currently selected by chooser.

getFilter
gtk.recent_filter.RecentFilter getFilter()

Gets the #GtkRecentFilter object currently used by chooser to affect the display of the recently used resources.

getItems
gtk.recent_info.RecentInfo[] getItems()

Gets the list of recently used resources in form of #GtkRecentInfo objects.

getLimit
int getLimit()

Gets the number of items returned by gtk.recent_chooser.RecentChooser.getItems and gtk.recent_chooser.RecentChooser.getUris.

getLocalOnly
bool getLocalOnly()

Gets whether only local resources should be shown in the recently used resources selector. See gtk.recent_chooser.RecentChooser.setLocalOnly

getSelectMultiple
bool getSelectMultiple()

Gets whether chooser can select multiple items.

getShowIcons
bool getShowIcons()

Retrieves whether chooser should show an icon near the resource.

getShowNotFound
bool getShowNotFound()

Retrieves whether chooser should show the recently used resources that were not found.

getShowPrivate
bool getShowPrivate()

Returns whether chooser should display recently used resources registered as private.

getShowTips
bool getShowTips()

Gets whether chooser should display tooltips containing the full path of a recently user resource.

getSortType
gtk.types.RecentSortType getSortType()

Gets the value set by gtk.recent_chooser.RecentChooser.setSortType.

getUris
string[] getUris()

Gets the URI of the recently used resources.

listFilters
gtk.recent_filter.RecentFilter[] listFilters()

Gets the #GtkRecentFilter objects held by chooser.

removeFilter
void removeFilter(gtk.recent_filter.RecentFilter filter)

Removes filter from the list of #GtkRecentFilter objects held by chooser.

selectAll
void selectAll()

Selects all the items inside chooser, if the chooser supports multiple selection.

selectUri
bool selectUri(string uri)

Selects uri inside chooser.

setCurrentUri
bool setCurrentUri(string uri)

Sets uri as the current URI for chooser.

setFilter
void setFilter(gtk.recent_filter.RecentFilter filter)

Sets filter as the current #GtkRecentFilter object used by chooser to affect the displayed recently used resources.

setLimit
void setLimit(int limit)

Sets the number of items that should be returned by gtk.recent_chooser.RecentChooser.getItems and gtk.recent_chooser.RecentChooser.getUris.

setLocalOnly
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 resources are guaranteed to be accessible through the operating system native file system.

setSelectMultiple
void setSelectMultiple(bool selectMultiple)

Sets whether chooser can select multiple items.

setShowIcons
void setShowIcons(bool showIcons)

Sets whether chooser should show an icon near the resource when displaying it.

setShowNotFound
void setShowNotFound(bool showNotFound)

Sets whether chooser should display the recently used resources that it didn’t find. This only applies to local resources.

setShowPrivate
void setShowPrivate(bool showPrivate)

Whether to show recently used resources marked registered as private.

setShowTips
void setShowTips(bool showTips)

Sets whether to show a tooltips containing the full path of each recently used resource in a #GtkRecentChooser widget.

setSortFunc
void setSortFunc(gtk.types.RecentSortFunc sortFunc)

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.

setSortType
void setSortType(gtk.types.RecentSortType sortType)

Changes the sorting order of the recently used resources list displayed by chooser.

unselectAll
void unselectAll()

Unselects all the items inside chooser.

unselectUri
void unselectUri(string uri)

Unselects uri inside chooser.

connectItemActivated
gulong connectItemActivated(T callback, Flag!"After" after)

Connect to ItemActivated signal.

connectSelectionChanged
gulong connectSelectionChanged(T callback, Flag!"After" after)

Connect to SelectionChanged signal.