gtkmm 4.14.0
Public Member Functions | Static Public Member Functions | Protected Member Functions | Related Functions | List of all members
Gtk::BoolFilter Class Reference

Filtering by boolean expressions. More...

#include <gtkmm/boolfilter.h>

Inheritance diagram for Gtk::BoolFilter:
Inheritance graph
[legend]

Public Member Functions

 BoolFilter (BoolFilter && src) noexcept
 
BoolFilteroperator= (BoolFilter && src) noexcept
 
 ~BoolFilter () noexcept override
 
GtkBoolFilter * gobj ()
 Provides access to the underlying C GObject. More...
 
const GtkBoolFilter * gobj () const
 Provides access to the underlying C GObject. More...
 
GtkBoolFilter * gobj_copy ()
 Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More...
 
Glib::RefPtr< Expression< bool > > get_expression ()
 Gets the expression that the filter uses to evaluate if an item should be filtered. More...
 
Glib::RefPtr< const Expression< bool > > get_expression () const
 Gets the expression that the filter uses to evaluate if an item should be filtered. More...
 
void set_expression (const Glib::RefPtr< Expression< bool > > & expression)
 Sets the expression that the filter uses to check if items should be filtered. More...
 
bool get_invert () const
 Returns whether the filter inverts the expression. More...
 
void set_invert (bool invert=true)
 Sets whether the filter should invert the expression. More...
 
Glib::PropertyProxy< Glib::RefPtr< Expression< bool > > > property_expression ()
 The boolean expression to evaluate on item. More...
 
Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Expression< bool > > > property_expression () const
 The boolean expression to evaluate on item. More...
 
Glib::PropertyProxy< bool > property_invert ()
 If the expression result should be inverted. More...
 
Glib::PropertyProxy_ReadOnly< bool > property_invert () const
 If the expression result should be inverted. More...
 
- Public Member Functions inherited from Gtk::Filter
 Filter (Filter && src) noexcept
 
Filteroperator= (Filter && src) noexcept
 
 ~Filter () noexcept override
 
GtkFilter * gobj ()
 Provides access to the underlying C GObject. More...
 
const GtkFilter * gobj () const
 Provides access to the underlying C GObject. More...
 
GtkFilter * gobj_copy ()
 Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More...
 
bool match (const Glib::RefPtr< Glib::ObjectBase > & item)
 Checks if the given item is matched by the filter or not. More...
 
Match get_strictness ()
 Gets the known strictness of filters. More...
 
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. More...
 
static Glib::RefPtr< BoolFiltercreate (const Glib::RefPtr< Expression< bool > > & expression)
 
- Static Public Member Functions inherited from Gtk::Filter
static GType get_type ()
 Get the GType for this class, for use with the underlying GObject type system. More...
 

Protected Member Functions

 BoolFilter (const Glib::RefPtr< Expression< bool > > & expression)
 
- Protected Member Functions inherited from Gtk::Filter
 Filter ()
 
void changed (Change change=Change::DIFFERENT)
 Notifies all users of the filter that it has changed. More...
 
virtual bool match_vfunc (const Glib::RefPtr< Glib::ObjectBase > & item)
 
virtual Match get_strictness_vfunc ()
 

Related Functions

(Note that these are not member functions.)

Glib::RefPtr< Gtk::BoolFilterwrap (GtkBoolFilter * object, bool take_copy=false)
 A Glib::wrap() method for this object. More...
 

Additional Inherited Members

- Public Types inherited from Gtk::Filter
enum class  Match {
  Match::SOME ,
  Match::NONE ,
  Match::ALL
}
 Describes the known strictness of a filter. More...
 
enum class  Change {
  Change::DIFFERENT ,
  Change::LESS_STRICT ,
  Change::MORE_STRICT
}
 Describes changes in a filter in more detail and allows objects using the filter to optimize refiltering items. More...
 

Detailed Description

Filtering by boolean expressions.

Gtk::BoolFilter is a simple filter that takes a boolean Gtk::Expression to determine whether to include items.

Since gtkmm 3.98:

Constructor & Destructor Documentation

◆ BoolFilter() [1/2]

Gtk::BoolFilter::BoolFilter ( BoolFilter &&  src)
noexcept

◆ ~BoolFilter()

Gtk::BoolFilter::~BoolFilter ( )
overridenoexcept

◆ BoolFilter() [2/2]

Gtk::BoolFilter::BoolFilter ( const Glib::RefPtr< Expression< bool > > &  expression)
explicitprotected

Member Function Documentation

◆ create()

static Glib::RefPtr< BoolFilter > Gtk::BoolFilter::create ( const Glib::RefPtr< Expression< bool > > &  expression)
static

◆ get_expression() [1/2]

Glib::RefPtr< Expression< bool > > Gtk::BoolFilter::get_expression ( )

Gets the expression that the filter uses to evaluate if an item should be filtered.

Returns
A Gtk::Expression.

◆ get_expression() [2/2]

Glib::RefPtr< const Expression< bool > > Gtk::BoolFilter::get_expression ( ) const

Gets the expression that the filter uses to evaluate if an item should be filtered.

Returns
A Gtk::Expression.

◆ get_invert()

bool Gtk::BoolFilter::get_invert ( ) const

Returns whether the filter inverts the expression.

Returns
true if the filter inverts.

◆ get_type()

static GType Gtk::BoolFilter::get_type ( )
static

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

◆ gobj() [1/2]

GtkBoolFilter * Gtk::BoolFilter::gobj ( )
inline

Provides access to the underlying C GObject.

◆ gobj() [2/2]

const GtkBoolFilter * Gtk::BoolFilter::gobj ( ) const
inline

Provides access to the underlying C GObject.

◆ gobj_copy()

GtkBoolFilter * Gtk::BoolFilter::gobj_copy ( )

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

◆ operator=()

BoolFilter & Gtk::BoolFilter::operator= ( BoolFilter &&  src)
noexcept

◆ property_expression() [1/2]

Glib::PropertyProxy< Glib::RefPtr< Expression< bool > > > Gtk::BoolFilter::property_expression ( )

The boolean expression to evaluate on item.

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< bool > > > Gtk::BoolFilter::property_expression ( ) const

The boolean expression to evaluate on item.

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

Glib::PropertyProxy< bool > Gtk::BoolFilter::property_invert ( )

If the expression result should be inverted.

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

Glib::PropertyProxy_ReadOnly< bool > Gtk::BoolFilter::property_invert ( ) const

If the expression result should be inverted.

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.

◆ set_expression()

void Gtk::BoolFilter::set_expression ( const Glib::RefPtr< Expression< bool > > &  expression)

Sets the expression that the filter uses to check if items should be filtered.

The expression must have a value type of G_TYPE_BOOLEAN.

Parameters
expressionA Gtk::Expression.

◆ set_invert()

void Gtk::BoolFilter::set_invert ( bool  invert = true)

Sets whether the filter should invert the expression.

Parameters
inverttrue to invert.

Friends And Related Function Documentation

◆ wrap()

Glib::RefPtr< Gtk::BoolFilter > wrap ( GtkBoolFilter *  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.