GtkStringFilter

GtkStringFilter — Filtering by string

Properties

GtkExpression * expression Read / Write
gboolean ignore-case Read / Write
GtkStringFilterMatchMode match-mode Read / Write
gchar * search Read / Write

Types and Values

Object Hierarchy

    GObject
    ╰── GtkFilter
        ╰── GtkStringFilter

Includes

#include <gtk/gtk.h>

Description

GtkStringFilter determines whether to include items by looking at strings and comparing them to a fixed search term. The strings are obtained from the items by evaluating a GtkExpression.

GtkStringFilter has several different modes of comparison - it can match the whole string, just a prefix, or any substring.

Functions

gtk_string_filter_new ()

GtkFilter *
gtk_string_filter_new (void);

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.

Returns

a new GtkStringFilter


gtk_string_filter_get_search ()

const char *
gtk_string_filter_get_search (GtkStringFilter *self);

Gets the search string set via gtk_string_filter_set_search().

Parameters

self

a GtkStringFilter

 

Returns

The search string.

[allow-none][transfer none]


gtk_string_filter_set_search ()

void
gtk_string_filter_set_search (GtkStringFilter *self,
                              const char *search);

Sets the string to search for.

Parameters

self

a GtkStringFilter

 

search

The string to search for or NULL to clear the search.

[transfer none][nullable]

gtk_string_filter_get_expression ()

GtkExpression *
gtk_string_filter_get_expression (GtkStringFilter *self);

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

Parameters

self

a GtkStringFilter

 

Returns

a GtkExpression.

[transfer none]


gtk_string_filter_set_expression ()

void
gtk_string_filter_set_expression (GtkStringFilter *self,
                                  GtkExpression *expression);

Sets the expression that the string filter uses to obtain strings from items. The expression must have a value type of G_TYPE_STRING.

Parameters

self

a GtkStringFilter

 

expression

a GtkExpression

 

gtk_string_filter_get_ignore_case ()

gboolean
gtk_string_filter_get_ignore_case (GtkStringFilter *self);

Returns whether the filter ignores case differences.

Parameters

self

a GtkStringFilter

 

Returns

TRUE if the filter ignores case


gtk_string_filter_set_ignore_case ()

void
gtk_string_filter_set_ignore_case (GtkStringFilter *self,
                                   gboolean ignore_case);

Sets whether the filter ignores case differences.

Parameters

self

a GtkStringFilter

 

ignore_case

TRUE to ignore case

 

gtk_string_filter_get_match_mode ()

GtkStringFilterMatchMode
gtk_string_filter_get_match_mode (GtkStringFilter *self);

Returns the match mode that the filter is using.

Parameters

self

a GtkStringFilter

 

Returns

the match mode of the filter


gtk_string_filter_set_match_mode ()

void
gtk_string_filter_set_match_mode (GtkStringFilter *self,
                                  GtkStringFilterMatchMode mode);

Sets the match mode fot the filter.

Parameters

self

a GtkStringFilter

 

mode

the new match mode

 

Types and Values

GtkStringFilter

typedef struct _GtkStringFilter GtkStringFilter;

enum GtkStringFilterMatchMode

Specifies how search strings are matched inside text.

Members

GTK_STRING_FILTER_MATCH_MODE_EXACT

The search string and text must match exactly.

 

GTK_STRING_FILTER_MATCH_MODE_SUBSTRING

The search string must be contained as a substring inside the text.

 

GTK_STRING_FILTER_MATCH_MODE_PREFIX

The text must begin with the search string.

 

Property Details

The “expression” property

  “expression”               GtkExpression *

The expression to evalute on item to get a string to compare with

[type GtkExpression]

Owner: GtkStringFilter

Flags: Read / Write


The “ignore-case” property

  “ignore-case”              gboolean

If matching is case sensitive

Owner: GtkStringFilter

Flags: Read / Write

Default value: TRUE


The “match-mode” property

  “match-mode”               GtkStringFilterMatchMode

If exact matches are necessary or if substrings are allowed

Owner: GtkStringFilter

Flags: Read / Write

Default value: GTK_STRING_FILTER_MATCH_MODE_SUBSTRING


The “search” property

  “search”                   gchar *

The search term

Owner: GtkStringFilter

Flags: Read / Write

Default value: NULL