class Gtk::StringFilter

Overview

GtkStringFilter determines whether to include items by comparing strings to a fixed search term.

The strings are obtained from the items by evaluating a GtkExpression set with Gtk::StringFilter#expression=, and they are compared against a search term set with Gtk::StringFilter#search=.

GtkStringFilter has several different modes of comparison - it can match the whole string, just a prefix, or any substring. Use Gtk::StringFilter#match_mode= choose a mode.

It is also possible to make case-insensitive comparisons, with Gtk::StringFilter#ignore_case=.

Defined in:

auto/gtk-4.0/string_filter.cr

Constructors

Class Method Summary

Instance Method Summary

Instance methods inherited from class Gtk::Filter

changed(change : Gtk::FilterChange) : Nil changed, changed_signal changed_signal, match(item : GObject::Object) : Bool match, strictness : Gtk::FilterMatch strictness

Constructor methods inherited from class Gtk::Filter

new new

Class methods inherited from class Gtk::Filter

g_type : UInt64 g_type

Instance methods inherited from class GObject::Object

bind_property(source_property : String, target : GObject::Object, target_property : String, flags : GObject::BindingFlags) : GObject::Binding bind_property, bind_property_full(source_property : String, target : GObject::Object, target_property : String, flags : GObject::BindingFlags, transform_to : GObject::Closure, transform_from : GObject::Closure) : GObject::Binding bind_property_full, data(key : String) : Pointer(Void)? data, finalize finalize, freeze_notify : Nil freeze_notify, getv(names : Enumerable(String), values : Enumerable(_)) : Nil getv, notify(property_name : String) : Nil notify, notify_by_pspec(pspec : GObject::ParamSpec) : Nil notify_by_pspec, notify_signal notify_signal, property(property_name : String, value : _) : Nil property, qdata(quark : UInt32) : Pointer(Void)? qdata, ref_count ref_count, run_dispose : Nil run_dispose, set_data(key : String, data : Pointer(Void)?) : Nil set_data, set_property(property_name : String, value : _) : Nil set_property, steal_data(key : String) : Pointer(Void)? steal_data, steal_qdata(quark : UInt32) : Pointer(Void)? steal_qdata, thaw_notify : Nil thaw_notify, to_unsafe : Pointer(Void) to_unsafe, watch_closure(closure : GObject::Closure) : Nil watch_closure

Constructor methods inherited from class GObject::Object

cast(obj : GObject::Object) : self cast, cast?(obj : GObject::Object) : self? cast?, new new, newv(object_type : UInt64, parameters : Enumerable(GObject::Parameter)) : self newv

Class methods inherited from class GObject::Object

compat_control(what : UInt64, data : Pointer(Void)?) : UInt64 compat_control, g_type : UInt64 g_type, interface_find_property(g_iface : GObject::TypeInterface, property_name : String) : GObject::ParamSpec interface_find_property, interface_list_properties(g_iface : GObject::TypeInterface) : Enumerable(GObject::ParamSpec) interface_list_properties

Constructor Detail

def self.new(expression : Gtk::Expression?) #

Creates a new string filter.

You will want to set up the filter by providing a string to search for and by providing a property to look up on the item.


def self.new #

Initialize a new StringFilter.


def self.new(*, expression : Gtk::Expression? = nil, ignore_case : Bool? = nil, match_mode : Gtk::StringFilterMatchMode? = nil, search : String? = nil) #

Class Method Detail

def self.g_type : UInt64 #

Returns the type id (GType) registered in GLib type system.


Instance Method Detail

def expression : Gtk::Expression? #

Gets the expression that the string filter uses to obtain strings from items.


def expression=(expression : Gtk::Expression?) : Nil #

Sets the expression that the string filter uses to obtain strings from items.

The expression must have a value type of %G_TYPE_STRING.


def ignore_case : Bool #

Returns whether the filter ignores case differences.


def ignore_case=(ignore_case : Bool) : Nil #

Sets whether the filter ignores case differences.


def ignore_case? : Bool #

def match_mode : Gtk::StringFilterMatchMode #

Returns the match mode that the filter is using.


def match_mode=(mode : Gtk::StringFilterMatchMode) : Nil #

Sets the match mode for the filter.


def search : String? #

Gets the search term.


def search=(value : String) : String #

def search=(search : String?) : Nil #

Sets the string to search for.