RecentChooser is an interface that can be implemented by widgets displaying the list of recently used files. More...

#include <gtkmm/recentchooser.h>

Inheritance diagram for Gtk::RecentChooser:

[legend]

Public Types
typedef sigc::slot< int, const Glib::RefPtr< RecentInfo > &, const Glib::RefPtr< RecentInfo > & >	SlotCompare
	This callback should return -1 if b compares before a, 0 if they compare equal and 1 if a compares after b. More...

Public Member Functions
	RecentChooser (RecentChooser && src) noexcept

RecentChooser &	operator= (RecentChooser && src) noexcept

	~RecentChooser () noexcept override

GtkRecentChooser *	gobj ()
	Provides access to the underlying C GObject. More...

const GtkRecentChooser *	gobj () const
	Provides access to the underlying C GObject. More...

void	set_show_private (bool show_private=true)
	Whether to show recently used resources marked registered as private. More...

bool	get_show_private () const
	Returns whether chooser should display recently used resources registered as private. More...

void	set_show_not_found (bool show_not_found=true)
	Sets whether chooser should display the recently used resources that it didn’t find. More...

bool	get_show_not_found () const
	Retrieves whether chooser should show the recently used resources that were not found. More...

void	set_select_multiple (bool select_multiple=true)
	Sets whether chooser can select multiple items. More...

bool	get_select_multiple () const
	Gets whether chooser can select multiple items. More...

void	set_limit (int limit)
	Sets the number of items that should be returned by get_items() and get_uris(). More...

void	unset_limit ()

int	get_limit () const
	Gets the number of items returned by get_items() and get_uris(). More...

void	set_local_only (bool local_only=true)
	Sets whether only local resources, that is resources using the file:// URI scheme, should be shown in the recently used resources selector. More...

bool	get_local_only () const
	Gets whether only local resources should be shown in the recently used resources selector. More...

void	set_show_tips (bool show_tips=true)
	Sets whether to show a tooltips containing the full path of each recently used resource in a Gtk::RecentChooser widget. More...

bool	get_show_tips () const
	Gets whether chooser should display tooltips containing the full path of a recently user resource. More...

void	set_show_icons (bool show_icons=true)
	Sets whether chooser should show an icon near the resource when displaying it. More...

bool	get_show_icons () const
	Retrieves whether chooser should show an icon near the resource. More...

void	set_sort_type (RecentSortType sort_type)
	Changes the sorting order of the recently used resources list displayed by chooser. More...

RecentSortType	get_sort_type () const
	Gets the value set by set_sort_type(). More...

void	set_sort_func (const SlotCompare & slot)
	Sets the comparison function used when sorting the list of recently used resources and the sort type is RECENT_SORT_CUSTOM. More...

bool	set_current_uri (const Glib::ustring & uri)
	Sets uri as the current URI for chooser. More...

Glib::ustring	get_current_uri () const
	Gets the URI currently selected by chooser. More...

Glib::RefPtr< RecentInfo >	get_current_item ()
	Gets the Gtk::RecentInfo currently selected by chooser. More...

Glib::RefPtr< const RecentInfo >	get_current_item () const
	Gets the Gtk::RecentInfo currently selected by chooser. More...

bool	select_uri (const Glib::ustring & uri)
	Selects uri inside chooser. More...

void	unselect_uri (const Glib::ustring & uri)
	Unselects uri inside chooser. More...

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

void	unselect_all ()
	Unselects all the items inside chooser. More...

std::vector< Glib::RefPtr< RecentInfo > >	get_items () const
	Gets the list of recently used resources in form of Gtk::RecentInfo objects. More...

std::vector< Glib::ustring >	get_uris () const
	Gets the URI of the recently used resources. More...

void	add_filter (const Glib::RefPtr< RecentFilter > & filter)
	Adds filter to the list of Gtk::RecentFilter objects held by chooser. More...

void	remove_filter (const Glib::RefPtr< RecentFilter > & filter)
	Removes filter from the list of Gtk::RecentFilter objects held by chooser. More...

std::vector< Glib::RefPtr< RecentFilter > >	list_filters ()
	Gets the Gtk::RecentFilter objects held by chooser. More...

std::vector< Glib::RefPtr< const RecentFilter > >	list_filters () const
	Gets the Gtk::RecentFilter objects held by chooser. More...

void	set_filter (const Glib::RefPtr< RecentFilter > & filter)
	Sets filter as the current Gtk::RecentFilter object used by chooser to affect the displayed recently used resources. More...

Glib::RefPtr< RecentFilter >	get_filter ()
	Gets the Gtk::RecentFilter object currently used by chooser to affect the display of the recently used resources. More...

Glib::RefPtr< const RecentFilter >	get_filter () const
	Gets the Gtk::RecentFilter object currently used by chooser to affect the display of the recently used resources. More...

Glib::SignalProxy< void >	signal_selection_changed ()

Glib::SignalProxy< void >	signal_item_activated ()

Glib::PropertyProxy< bool >	property_show_private ()
	Whether the private items should be displayed. More...

Glib::PropertyProxy_ReadOnly< bool >	property_show_private () const
	Whether the private items should be displayed. More...

Glib::PropertyProxy< bool >	property_show_tips ()
	Whether this Gtk::RecentChooser should display a tooltip containing the full path of the recently used resources. More...

Glib::PropertyProxy_ReadOnly< bool >	property_show_tips () const
	Whether this Gtk::RecentChooser should display a tooltip containing the full path of the recently used resources. More...

Glib::PropertyProxy< bool >	property_show_icons ()
	Whether this Gtk::RecentChooser should display an icon near the item. More...

Glib::PropertyProxy_ReadOnly< bool >	property_show_icons () const
	Whether this Gtk::RecentChooser should display an icon near the item. More...

Glib::PropertyProxy< bool >	property_show_not_found ()
	Whether this Gtk::RecentChooser should display the recently used resources even if not present anymore. More...

Glib::PropertyProxy_ReadOnly< bool >	property_show_not_found () const
	Whether this Gtk::RecentChooser should display the recently used resources even if not present anymore. More...

Glib::PropertyProxy< bool >	property_select_multiple ()
	Allow the user to select multiple resources. More...

Glib::PropertyProxy_ReadOnly< bool >	property_select_multiple () const
	Allow the user to select multiple resources. More...

Glib::PropertyProxy< bool >	property_local_only ()
	Whether this Gtk::RecentChooser should display only local (file:) resources. More...

Glib::PropertyProxy_ReadOnly< bool >	property_local_only () const
	Whether this Gtk::RecentChooser should display only local (file:) resources. More...

Glib::PropertyProxy< int >	property_limit ()
	The maximum number of recently used resources to be displayed, or -1 to display all items. More...

Glib::PropertyProxy_ReadOnly< int >	property_limit () const
	The maximum number of recently used resources to be displayed, or -1 to display all items. More...

Glib::PropertyProxy< RecentSortType >	property_sort_type ()
	Sorting order to be used when displaying the recently used resources. More...

Glib::PropertyProxy_ReadOnly< RecentSortType >	property_sort_type () const
	Sorting order to be used when displaying the recently used resources. More...

Glib::PropertyProxy< Glib::RefPtr< RecentFilter > >	property_filter ()
	The Gtk::RecentFilter object to be used when displaying the recently used resources. More...

Glib::PropertyProxy_ReadOnly< Glib::RefPtr< RecentFilter > >	property_filter () const
	The Gtk::RecentFilter object to be used when displaying the recently used resources. More...

Static Public Member Functions
static void	add_interface (GType gtype_implementer)

static GType	get_type ()
	Get the GType for this class, for use with the underlying GObject type system. More...

Protected Member Functions
	RecentChooser ()
	You should derive from this class to use it. More...

virtual Glib::ustring	get_current_uri_vfunc () const

virtual void	unselect_uri_vfunc (const Glib::ustring & uri)

virtual void	select_all_vfunc ()

virtual void	unselect_all_vfunc ()

virtual Glib::RefPtr< RecentManager >	get_recent_manager_vfunc ()

virtual void	add_filter_vfunc (const Glib::RefPtr< RecentFilter > & filter)

virtual void	remove_filter_vfunc (const Glib::RefPtr< RecentFilter > & filter)

virtual void	on_selection_changed ()
	This is a default handler for the signal signal_selection_changed(). More...

virtual void	on_item_activated ()
	This is a default handler for the signal signal_item_activated(). More...

Related Functions
(Note that these are not member functions.)
Glib::RefPtr< Gtk::RecentChooser >	wrap (GtkRecentChooser * object, bool take_copy=false)
	A Glib::wrap() method for this object. More...

Detailed Description

RecentChooser 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 RecentChooserWidget, RecentChooserDialog and RecentChooserMenu.

Since gtkmm 2.10:

Member Typedef Documentation

◆ SlotCompare

typedef sigc::slot<int, const Glib::RefPtr<RecentInfo>&, const Glib::RefPtr<RecentInfo>&> Gtk::RecentChooser::SlotCompare

This callback should return -1 if b compares before a, 0 if they compare equal and 1 if a compares after b.

For instance, int on_sort_compare(const Glib::RefPtr<Gtk::RecentInfo>& a, const Gtk::RecentInfo& b);

Constructor & Destructor Documentation

◆ RecentChooser() [1/2]

Gtk::RecentChooser::RecentChooser ( )

protected

You should derive from this class to use it.

◆ RecentChooser() [2/2]

Gtk::RecentChooser::RecentChooser ( RecentChooser && src )

noexcept

◆ ~RecentChooser()

Gtk::RecentChooser::~RecentChooser ( )

overridenoexcept

Member Function Documentation

◆ add_filter()

void Gtk::RecentChooser::add_filter ( const Glib::RefPtr< RecentFilter > & filter )

Adds filter to the list of Gtk::RecentFilter objects held by chooser.

If no previous filter objects were defined, this function will call set_filter().

Since gtkmm 2.10:

Parameters

filter A Gtk::RecentFilter.

◆ add_filter_vfunc()

virtual void Gtk::RecentChooser::add_filter_vfunc ( const Glib::RefPtr< RecentFilter > & filter )

protectedvirtual

◆ add_interface()

static void Gtk::RecentChooser::add_interface ( GType gtype_implementer )

static

◆ get_current_item() [1/2]

Glib::RefPtr< RecentInfo > Gtk::RecentChooser::get_current_item ( )

Gets the Gtk::RecentInfo currently selected by chooser.

Since gtkmm 2.10:

Returns: A Gtk::RecentInfo. Use Gtk::RecentInfo::unref() when when you have finished using it.

◆ get_current_item() [2/2]

Glib::RefPtr< const RecentInfo > Gtk::RecentChooser::get_current_item ( ) const

Gets the Gtk::RecentInfo currently selected by chooser.

Since gtkmm 2.10:

Returns: A Gtk::RecentInfo. Use Gtk::RecentInfo::unref() when when you have finished using it.

◆ get_current_uri()

Glib::ustring Gtk::RecentChooser::get_current_uri ( ) const

Gets the URI currently selected by chooser.

Since gtkmm 2.10:

Returns: A newly allocated string holding a URI.

◆ get_current_uri_vfunc()

virtual Glib::ustring Gtk::RecentChooser::get_current_uri_vfunc ( ) const

protectedvirtual

◆ get_filter() [1/2]

Glib::RefPtr< RecentFilter > Gtk::RecentChooser::get_filter ( )

Gets the Gtk::RecentFilter object currently used by chooser to affect the display of the recently used resources.

Since gtkmm 2.10:

Returns: A Gtk::RecentFilter object.

◆ get_filter() [2/2]

Glib::RefPtr< const RecentFilter > Gtk::RecentChooser::get_filter ( ) const

Gets the Gtk::RecentFilter object currently used by chooser to affect the display of the recently used resources.

Since gtkmm 2.10:

Returns: A Gtk::RecentFilter object.

◆ get_items()

std::vector< Glib::RefPtr< RecentInfo > > Gtk::RecentChooser::get_items ( ) const

Gets the list of recently used resources in form of Gtk::RecentInfo objects.

The return value of this function is affected by the “sort-type” and “limit” properties of chooser.

Since gtkmm 2.10:

Returns: A newly allocated list of Gtk::RecentInfo objects.

◆ get_limit()

int Gtk::RecentChooser::get_limit ( ) const

Gets the number of items returned by get_items() and get_uris().

Since gtkmm 2.10:

Returns: A positive integer, or -1 meaning that all items are returned.

◆ get_local_only()

bool Gtk::RecentChooser::get_local_only ( ) const

Gets whether only local resources should be shown in the recently used resources selector.

See set_local_only()

Since gtkmm 2.10:

Returns: true if only local resources should be shown.

◆ get_recent_manager_vfunc()

virtual Glib::RefPtr< RecentManager > Gtk::RecentChooser::get_recent_manager_vfunc ( )

protectedvirtual

◆ get_select_multiple()

bool Gtk::RecentChooser::get_select_multiple ( ) const

Gets whether chooser can select multiple items.

Since gtkmm 2.10:

Returns: true if chooser can select more than one item.

◆ get_show_icons()

bool Gtk::RecentChooser::get_show_icons ( ) const

Retrieves whether chooser should show an icon near the resource.

Since gtkmm 2.10:

Returns: true if the icons should be displayed, false otherwise.

◆ get_show_not_found()

bool Gtk::RecentChooser::get_show_not_found ( ) const

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

Since gtkmm 2.10:

Returns: true if the resources not found should be displayed, and false otheriwse.

◆ get_show_private()

bool Gtk::RecentChooser::get_show_private ( ) const

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

Since gtkmm 2.10:

Returns: true if the recent chooser should show private items, false otherwise.

◆ get_show_tips()

bool Gtk::RecentChooser::get_show_tips ( ) const

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

Since gtkmm 2.10:

Returns: true if the recent chooser should show tooltips, false otherwise.

◆ get_sort_type()

RecentSortType Gtk::RecentChooser::get_sort_type ( ) const

Gets the value set by set_sort_type().

Since gtkmm 2.10:

Returns: The sorting order of the chooser.

◆ get_type()

static GType Gtk::RecentChooser::get_type ( )

static

Get the GType for this class, for use with the underlying GObject type system.

◆ get_uris()

std::vector< Glib::ustring > Gtk::RecentChooser::get_uris ( ) const

Gets the URI of the recently used resources.

The return value of this function is affected by the "sort-type" and "limit" properties of the recent chooser.

◆ gobj() [1/2]

GtkRecentChooser * Gtk::RecentChooser::gobj ( )

inline

Provides access to the underlying C GObject.

◆ gobj() [2/2]

const GtkRecentChooser * Gtk::RecentChooser::gobj ( ) const

inline

Provides access to the underlying C GObject.

◆ list_filters() [1/2]

std::vector< Glib::RefPtr< RecentFilter > > Gtk::RecentChooser::list_filters ( )

Gets the Gtk::RecentFilter objects held by chooser.

Since gtkmm 2.10:

Returns: A singly linked list of Gtk::RecentFilter objects.

◆ list_filters() [2/2]

std::vector< Glib::RefPtr< const RecentFilter > > Gtk::RecentChooser::list_filters ( ) const

Gets the Gtk::RecentFilter objects held by chooser.

Since gtkmm 2.10:

Returns: A singly linked list of Gtk::RecentFilter objects.

◆ on_item_activated()

virtual void Gtk::RecentChooser::on_item_activated ( )

protectedvirtual

This is a default handler for the signal signal_item_activated().

◆ on_selection_changed()

virtual void Gtk::RecentChooser::on_selection_changed ( )

protectedvirtual

This is a default handler for the signal signal_selection_changed().

◆ operator=()

RecentChooser & Gtk::RecentChooser::operator= ( RecentChooser && src )

noexcept

◆ property_filter() [1/2]

Glib::PropertyProxy< Glib::RefPtr< RecentFilter > > Gtk::RecentChooser::property_filter ( )

The Gtk::RecentFilter object to be used when displaying the recently used resources.

Since gtkmm 2.10:

Returns: A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_filter() [2/2]

Glib::PropertyProxy_ReadOnly< Glib::RefPtr< RecentFilter > > Gtk::RecentChooser::property_filter ( ) const

The Gtk::RecentFilter object to be used when displaying the recently used resources.

Since gtkmm 2.10:

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_limit() [1/2]

Glib::PropertyProxy< int > Gtk::RecentChooser::property_limit ( )

The maximum number of recently used resources to be displayed, or -1 to display all items.

Since gtkmm 2.10:

Default value: 50

Returns: A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_limit() [2/2]

Glib::PropertyProxy_ReadOnly< int > Gtk::RecentChooser::property_limit ( ) const

The maximum number of recently used resources to be displayed, or -1 to display all items.

Since gtkmm 2.10:

Default value: 50

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_local_only() [1/2]

Glib::PropertyProxy< bool > Gtk::RecentChooser::property_local_only ( )

Whether this Gtk::RecentChooser should display only local (file:) resources.

Since gtkmm 2.10:

Default value: true

Returns: A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_local_only() [2/2]

Glib::PropertyProxy_ReadOnly< bool > Gtk::RecentChooser::property_local_only ( ) const

Whether this Gtk::RecentChooser should display only local (file:) resources.

Since gtkmm 2.10:

Default value: true

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_select_multiple() [1/2]

Glib::PropertyProxy< bool > Gtk::RecentChooser::property_select_multiple ( )

Allow the user to select multiple resources.

Since gtkmm 2.10:

Default value: false

Returns: A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_select_multiple() [2/2]

Glib::PropertyProxy_ReadOnly< bool > Gtk::RecentChooser::property_select_multiple ( ) const

Allow the user to select multiple resources.

Since gtkmm 2.10:

Default value: false

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_show_icons() [1/2]

Glib::PropertyProxy< bool > Gtk::RecentChooser::property_show_icons ( )

Whether this Gtk::RecentChooser should display an icon near the item.

Since gtkmm 2.10:

Default value: true

Returns: A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_show_icons() [2/2]

Glib::PropertyProxy_ReadOnly< bool > Gtk::RecentChooser::property_show_icons ( ) const

Whether this Gtk::RecentChooser should display an icon near the item.

Since gtkmm 2.10:

Default value: true

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_show_not_found() [1/2]

Glib::PropertyProxy< bool > Gtk::RecentChooser::property_show_not_found ( )

Whether this Gtk::RecentChooser 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).

Since gtkmm 2.10:

Default value: true

Returns: A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_show_not_found() [2/2]

Glib::PropertyProxy_ReadOnly< bool > Gtk::RecentChooser::property_show_not_found ( ) const

Whether this Gtk::RecentChooser 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).

Since gtkmm 2.10:

Default value: true

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_show_private() [1/2]

Glib::PropertyProxy< bool > Gtk::RecentChooser::property_show_private ( )

Whether the private items should be displayed.

Default value: false

Returns: A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_show_private() [2/2]

Glib::PropertyProxy_ReadOnly< bool > Gtk::RecentChooser::property_show_private ( ) const

Whether the private items should be displayed.

Default value: false

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_show_tips() [1/2]

Glib::PropertyProxy< bool > Gtk::RecentChooser::property_show_tips ( )

Whether this Gtk::RecentChooser should display a tooltip containing the full path of the recently used resources.

Since gtkmm 2.10:

Default value: false

Returns: A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_show_tips() [2/2]

Glib::PropertyProxy_ReadOnly< bool > Gtk::RecentChooser::property_show_tips ( ) const

Whether this Gtk::RecentChooser should display a tooltip containing the full path of the recently used resources.

Since gtkmm 2.10:

Default value: false

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_sort_type() [1/2]

Glib::PropertyProxy< RecentSortType > Gtk::RecentChooser::property_sort_type ( )

Sorting order to be used when displaying the recently used resources.

Since gtkmm 2.10:

Default value: Gtk::RECENT_SORT_NONE

Returns: A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_sort_type() [2/2]

Glib::PropertyProxy_ReadOnly< RecentSortType > Gtk::RecentChooser::property_sort_type ( ) const

Sorting order to be used when displaying the recently used resources.

Since gtkmm 2.10:

Default value: Gtk::RECENT_SORT_NONE

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ remove_filter()

void Gtk::RecentChooser::remove_filter ( const Glib::RefPtr< RecentFilter > & filter )

Removes filter from the list of Gtk::RecentFilter objects held by chooser.

Since gtkmm 2.10:

Parameters

filter A Gtk::RecentFilter.

◆ remove_filter_vfunc()

virtual void Gtk::RecentChooser::remove_filter_vfunc ( const Glib::RefPtr< RecentFilter > & filter )

protectedvirtual

◆ select_all()

void Gtk::RecentChooser::select_all ( )

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

Since gtkmm 2.10:

◆ select_all_vfunc()

virtual void Gtk::RecentChooser::select_all_vfunc ( )

protectedvirtual

◆ select_uri()

bool Gtk::RecentChooser::select_uri ( const Glib::ustring & uri )

Selects uri inside chooser.

Since gtkmm 2.10:

Parameters

uri A URI.

Returns: true if uri was found.

Exceptions

Glib::Error

◆ set_current_uri()

bool Gtk::RecentChooser::set_current_uri ( const Glib::ustring & uri )

Sets uri as the current URI for chooser.

Since gtkmm 2.10:

Parameters

uri A URI.

Returns: true if the URI was found.

Exceptions

Glib::Error

◆ set_filter()

void Gtk::RecentChooser::set_filter ( const Glib::RefPtr< RecentFilter > & filter )

Sets filter as the current Gtk::RecentFilter object used by chooser to affect the displayed recently used resources.

Since gtkmm 2.10:

Parameters

filter A Gtk::RecentFilter.

◆ set_limit()

void Gtk::RecentChooser::set_limit ( int limit )

Sets the number of items that should be returned by get_items() and get_uris().

Since gtkmm 2.10:

Parameters

limit A positive integer, or -1 for all items.

◆ set_local_only()

void Gtk::RecentChooser::set_local_only ( bool local_only = true )

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 gtkmm 2.10:

Parameters

local_only true if only local files can be shown.

◆ set_select_multiple()

void Gtk::RecentChooser::set_select_multiple ( bool select_multiple = true )

Sets whether chooser can select multiple items.

Since gtkmm 2.10:

Parameters

select_multiple true if chooser can select more than one item.

◆ set_show_icons()

void Gtk::RecentChooser::set_show_icons ( bool show_icons = true )

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

Since gtkmm 2.10:

Parameters

show_icons Whether to show an icon near the resource.

◆ set_show_not_found()

void Gtk::RecentChooser::set_show_not_found ( bool show_not_found = true )

Sets whether chooser should display the recently used resources that it didn’t find.

This only applies to local resources.

Since gtkmm 2.10:

Parameters

show_not_found Whether to show the local items we didn’t find.

◆ set_show_private()

void Gtk::RecentChooser::set_show_private ( bool show_private = true )

Whether to show recently used resources marked registered as private.

Since gtkmm 2.10:

Parameters

show_private true to show private items, false otherwise.

◆ set_show_tips()

void Gtk::RecentChooser::set_show_tips ( bool show_tips = true )

Sets whether to show a tooltips containing the full path of each recently used resource in a Gtk::RecentChooser widget.

Since gtkmm 2.10:

Parameters

show_tips true if tooltips should be shown.

◆ set_sort_func()

void Gtk::RecentChooser::set_sort_func ( const SlotCompare & slot )

Sets the comparison function used when sorting the list of recently used resources and the sort type is RECENT_SORT_CUSTOM.

◆ set_sort_type()

void Gtk::RecentChooser::set_sort_type ( RecentSortType sort_type )

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

Since gtkmm 2.10:

Parameters

sort_type Sort order that the chooser should use.

◆ signal_item_activated()

Glib::SignalProxy< void > Gtk::RecentChooser::signal_item_activated ( )

Slot Prototype:: void on_my_item_activated()

Flags: Run Last

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 gtkmm 2.10:

◆ signal_selection_changed()

Glib::SignalProxy< void > Gtk::RecentChooser::signal_selection_changed ( )

Slot Prototype:: void on_my_selection_changed()

Flags: Run Last

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 explicitly calling functions to change the selection.

Since gtkmm 2.10:

◆ unselect_all()

void Gtk::RecentChooser::unselect_all ( )

Unselects all the items inside chooser.

Since gtkmm 2.10:

◆ unselect_all_vfunc()

virtual void Gtk::RecentChooser::unselect_all_vfunc ( )

protectedvirtual

◆ unselect_uri()

void Gtk::RecentChooser::unselect_uri ( const Glib::ustring & uri )

Unselects uri inside chooser.

Since gtkmm 2.10:

Parameters

uri A URI.

◆ unselect_uri_vfunc()

virtual void Gtk::RecentChooser::unselect_uri_vfunc ( const Glib::ustring & uri )

protectedvirtual

◆ unset_limit()

void Gtk::RecentChooser::unset_limit ( )

Friends And Related Function Documentation

◆ wrap()

Glib::RefPtr< Gtk::RecentChooser > wrap	(	GtkRecentChooser *	object,
		bool	take_copy = `false`
	)

Parameters

object	The C instance.
take_copy	False if the result should take ownership of the C instance. True if it should take a new copy or ref.

Returns: A C++ instance that wraps this C instance.

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Related Functions

Detailed Description

Member Typedef Documentation

◆ SlotCompare

Constructor & Destructor Documentation

◆ RecentChooser() [1/2]

◆ RecentChooser() [2/2]

◆ ~RecentChooser()

Member Function Documentation

◆ add_filter()

◆ add_filter_vfunc()

◆ add_interface()

◆ get_current_item() [1/2]

◆ get_current_item() [2/2]

◆ get_current_uri()

◆ get_current_uri_vfunc()

◆ get_filter() [1/2]

◆ get_filter() [2/2]

◆ get_items()

◆ get_limit()

◆ get_local_only()

◆ get_recent_manager_vfunc()

◆ get_select_multiple()

◆ get_show_icons()

◆ get_show_not_found()

◆ get_show_private()

◆ get_show_tips()

◆ get_sort_type()

◆ get_type()

◆ get_uris()

◆ gobj() [1/2]

◆ gobj() [2/2]

◆ list_filters() [1/2]

◆ list_filters() [2/2]

◆ on_item_activated()

◆ on_selection_changed()

◆ operator=()

◆ property_filter() [1/2]

◆ property_filter() [2/2]

◆ property_limit() [1/2]

◆ property_limit() [2/2]

◆ property_local_only() [1/2]

◆ property_local_only() [2/2]

◆ property_select_multiple() [1/2]

◆ property_select_multiple() [2/2]

◆ property_show_icons() [1/2]

◆ property_show_icons() [2/2]

◆ property_show_not_found() [1/2]

◆ property_show_not_found() [2/2]

◆ property_show_private() [1/2]

◆ property_show_private() [2/2]

◆ property_show_tips() [1/2]

◆ property_show_tips() [2/2]

◆ property_sort_type() [1/2]

◆ property_sort_type() [2/2]

◆ remove_filter()

◆ remove_filter_vfunc()

◆ select_all()

◆ select_all_vfunc()

◆ select_uri()

◆ set_current_uri()

◆ set_filter()

◆ set_limit()

◆ set_local_only()

◆ set_select_multiple()

◆ set_show_icons()

◆ set_show_not_found()

◆ set_show_private()

◆ set_show_tips()

◆ set_sort_func()

◆ set_sort_type()

◆ signal_item_activated()

◆ signal_selection_changed()

◆ unselect_all()

◆ unselect_all_vfunc()

◆ unselect_uri()