gtkmm 3.24.7
Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Related Functions | List of all members
Gtk::RecentChooser Class Reference

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:
Inheritance graph
[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
 
RecentChooseroperator= (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< RecentInfoget_current_item ()
 Gets the Gtk::RecentInfo currently selected by chooser. More...
 
Glib::RefPtr< const RecentInfoget_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< RecentFilterget_filter ()
 Gets the Gtk::RecentFilter object currently used by chooser to affect the display of the recently used resources. More...
 
Glib::RefPtr< const RecentFilterget_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< RecentSortTypeproperty_sort_type ()
 Sorting order to be used when displaying the recently used resources. More...
 
Glib::PropertyProxy_ReadOnly< RecentSortTypeproperty_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< RecentManagerget_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::RecentChooserwrap (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
filterA 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
filterA 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
uriA 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
uriA 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
filterA 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
limitA 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_onlytrue 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_multipletrue 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_iconsWhether 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_foundWhether 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_privatetrue 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_tipstrue 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_typeSort 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
uriA 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 
)
related

A Glib::wrap() method for this object.

Parameters
objectThe C instance.
take_copyFalse 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.