Gtk::StringSorter Class Reference

Sort by comparing strings. More...

#include <gtkmm/stringsorter.h>

Inheritance diagram for Gtk::StringSorter:

Public Member Functions
	StringSorter (StringSorter &&src) noexcept
StringSorter &	operator= (StringSorter &&src) noexcept
	~StringSorter () noexcept override
GtkStringSorter *	gobj ()
	Provides access to the underlying C GObject.
const GtkStringSorter *	gobj () const
	Provides access to the underlying C GObject.
GtkStringSorter *	gobj_copy ()
	Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
Glib::RefPtr< Expression< Glib::ustring > >	get_expression ()
	Gets the expression that is evaluated to obtain strings from items.
Glib::RefPtr< const Expression< Glib::ustring > >	get_expression () const
	Gets the expression that is evaluated to obtain strings from items.
void	set_expression (const Glib::RefPtr< Expression< Glib::ustring > > &expression)
	Sets the expression that is evaluated to obtain strings from items.
bool	get_ignore_case () const
	Gets whether the sorter ignores case differences.
void	set_ignore_case (bool ignore_case=true)
	Sets whether the sorter will ignore case differences.
void	set_collation (Collation collation)
	Sets the collation method to use for sorting.
Collation	get_collation () const
	Gets which collation method the sorter uses.
Glib::PropertyProxy< Glib::RefPtr< Expression< Glib::ustring > > >	property_expression ()
	The expression to evaluate on item to get a string to compare with.
Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Expression< Glib::ustring > > >	property_expression () const
	The expression to evaluate on item to get a string to compare with.
Glib::PropertyProxy< bool >	property_ignore_case ()
	If sorting is case sensitive.
Glib::PropertyProxy_ReadOnly< bool >	property_ignore_case () const
	If sorting is case sensitive.
Glib::PropertyProxy< Collation >	property_collation ()
	The collation method to use for sorting.
Glib::PropertyProxy_ReadOnly< Collation >	property_collation () const
	The collation method to use for sorting.
Public Member Functions inherited from Gtk::Sorter
	Sorter (Sorter &&src) noexcept
Sorter &	operator= (Sorter &&src) noexcept
	~Sorter () noexcept override
GtkSorter *	gobj ()
	Provides access to the underlying C GObject.
const GtkSorter *	gobj () const
	Provides access to the underlying C GObject.
GtkSorter *	gobj_copy ()
	Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
Ordering	compare (gpointer item1, gpointer item2)
	Compares two given items according to the sort order implemented by the sorter.
Order	get_order () const
	Gets the order that self conforms to.
void	changed (Change change)
	Notifies all users of the sorter that it has changed.
Glib::SignalProxy< void(Change)>	signal_changed ()

Static Public Member Functions
static GType	get_type ()
	Get the GType for this class, for use with the underlying GObject type system.
static Glib::RefPtr< StringSorter >	create (const Glib::RefPtr< Expression< Glib::ustring > > &expression)
Static Public Member Functions inherited from Gtk::Sorter
static GType	get_type ()
	Get the GType for this class, for use with the underlying GObject type system.

Protected Member Functions
	StringSorter (const Glib::RefPtr< Expression< Glib::ustring > > &expression)
Protected Member Functions inherited from Gtk::Sorter
	Sorter ()
virtual Ordering	compare_vfunc (gpointer item1, gpointer item2)
virtual Order	get_order_vfunc ()

Related Symbols
(Note that these are not member symbols.)
Glib::RefPtr< Gtk::StringSorter >	wrap (GtkStringSorter *object, bool take_copy=false)
	A Glib::wrap() method for this object.
Related Symbols inherited from Gtk::Sorter
Glib::RefPtr< Gtk::Sorter >	wrap (GtkSorter *object, bool take_copy=false)
	A Glib::wrap() method for this object.

Additional Inherited Members
Public Types inherited from Gtk::Sorter
enum class	Order {   Order::PARTIAL ,   Order::NONE ,   Order::TOTAL }
	Describes the type of order that a Gtk::Sorter may produce. More...
enum class	Change {   Change::DIFFERENT ,   Change::INVERTED ,   Change::LESS_STRICT ,   Change::MORE_STRICT }
	Describes changes in a sorter in more detail and allows users to optimize resorting. More...

Detailed Description

Sort by comparing strings.

Gtk::StringSorter is a Gtk::Sorter that compares strings. It does the comparison in a linguistically correct way using the current locale by normalizing Unicode strings and possibly case-folding them before performing the comparison.

To obtain the strings to compare, this sorter evaluates a Gtk::Expression.

See also

Gtk::Expression

Since gtkmm 3.98:

Constructor & Destructor Documentation

StringSorter() [1/2]

Gtk::StringSorter::StringSorter ( StringSorter &&  src )

noexcept

~StringSorter()

Gtk::StringSorter::~StringSorter ( )

overridenoexcept

StringSorter() [2/2]

Gtk::StringSorter::StringSorter ( const Glib::RefPtr< Expression< Glib::ustring > > &  expression )

explicitprotected

Member Function Documentation

create()

static Glib::RefPtr< StringSorter > Gtk::StringSorter::create ( const Glib::RefPtr< Expression< Glib::ustring > > &  expression )

static

get_collation()

Collation Gtk::StringSorter::get_collation

(

)

const

Gets which collation method the sorter uses.

Since gtkmm 4.10:

Returns

The collation method.

get_expression() [1/2]

Glib::RefPtr< Expression< Glib::ustring > > Gtk::StringSorter::get_expression

(

)

Gets the expression that is evaluated to obtain strings from items.

Returns

A Gtk::Expression.

get_expression() [2/2]

Glib::RefPtr< const Expression< Glib::ustring > > Gtk::StringSorter::get_expression

(

)

const

Gets the expression that is evaluated to obtain strings from items.

Returns

A Gtk::Expression.

get_ignore_case()

bool Gtk::StringSorter::get_ignore_case

(

)

const

Gets whether the sorter ignores case differences.

Returns

true if self is ignoring case differences.

get_type()

static GType Gtk::StringSorter::get_type ( )

static

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

gobj() [1/2]

GtkStringSorter * Gtk::StringSorter::gobj ( )

inline

Provides access to the underlying C GObject.

gobj() [2/2]

const GtkStringSorter * Gtk::StringSorter::gobj ( ) const

inline

Provides access to the underlying C GObject.

gobj_copy()

GtkStringSorter * Gtk::StringSorter::gobj_copy

(

)

Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.

operator=()

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

noexcept

property_collation() [1/2]

Glib::PropertyProxy< Collation > Gtk::StringSorter::property_collation

(

)

The collation method to use for sorting.

The Gtk::Collation::NONE value is useful when the expression already returns collation keys, or strings that need to be compared byte-by-byte.

The default value, Gtk::Collation::UNICODE, compares strings according to the Unicode collation algorithm.

Since gtkmm 4.10:

Default value: Gtk::Collation::UNICODE

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_collation() [2/2]

Glib::PropertyProxy_ReadOnly< Collation > Gtk::StringSorter::property_collation

(

)

const

The collation method to use for sorting.

The Gtk::Collation::NONE value is useful when the expression already returns collation keys, or strings that need to be compared byte-by-byte.

The default value, Gtk::Collation::UNICODE, compares strings according to the Unicode collation algorithm.

Since gtkmm 4.10:

Default value: Gtk::Collation::UNICODE

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_expression() [1/2]

Glib::PropertyProxy< Glib::RefPtr< Expression< Glib::ustring > > > Gtk::StringSorter::property_expression

(

)

The expression to evaluate on item to get a string to compare with.

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_expression() [2/2]

Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Expression< Glib::ustring > > > Gtk::StringSorter::property_expression

(

)

const

The expression to evaluate on item to get a string to compare with.

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_ignore_case() [1/2]

Glib::PropertyProxy< bool > Gtk::StringSorter::property_ignore_case

(

)

If sorting is case sensitive.

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_ignore_case() [2/2]

Glib::PropertyProxy_ReadOnly< bool > Gtk::StringSorter::property_ignore_case

(

)

const

If sorting is case sensitive.

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.

set_collation()

void Gtk::StringSorter::set_collation

(

Collation

collation

)

Sets the collation method to use for sorting.

Since gtkmm 4.10:

Parameters

collation

The collation method.

set_expression()

void Gtk::StringSorter::set_expression

(

const Glib::RefPtr< Expression< Glib::ustring > > &

expression

)

Sets the expression that is evaluated to obtain strings from items.

The expression must have the type G_TYPE_STRING.

Parameters

expression

A Gtk::Expression.

set_ignore_case()

void Gtk::StringSorter::set_ignore_case

(

bool

ignore_case = true

)

Sets whether the sorter will ignore case differences.

Parameters

ignore_case

true to ignore case differences.

Friends And Related Symbol Documentation

wrap()

Glib::RefPtr< Gtk::StringSorter > wrap ( GtkStringSorter *  object, bool  take_copy = false  )

related

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

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.