OssoABookFilterModel

typedef struct _OssoABookFilterModel OssoABookFilterModel;

There are no public fields in OssoABookFilterModel.

osso_abook_filter_model_new ()

OssoABookFilterModel* osso_abook_filter_model_new
                                            (OssoABookTreeModel *child_model);

Creates a new OssoABookFilterModel object filtering the contents of child_model.

osso_abook_filter_model_set_group ()

void        osso_abook_filter_model_set_group
                                            (OssoABookFilterModel *model,
                                             OssoABookGroup *group);

Sets model to filter on group, only letting through EContact - OssoABookPresence combinations that satisfy group. (And the text set by osso_abook_filter_model_set_text(), if any)

osso_abook_filter_model_get_group ()

OssoABookGroup* osso_abook_filter_model_get_group
                                            (OssoABookFilterModel *model);

Retrieves the OssoABookGroup that is being filtered on.

osso_abook_filter_model_set_text ()

void        osso_abook_filter_model_set_text
                                            (OssoABookFilterModel *model,
                                             const char *text);

Sets model to filter on text, only letting through EContacts whose names contain text. (And the group set by osso_abook_filter_model_set_group(), if any)

text is split up into bits, using space as delimiter. The order in which the bits appear in the searched text is not of importance. Case and accents are ignored. This means that for example "Elvis Presley" matches "Presley Elvis", and that "Björk" matches "bjork".

osso_abook_filter_model_get_text ()

const char* osso_abook_filter_model_get_text
                                            (OssoABookFilterModel *model);

Retrieves the text that is being filtered on.

osso_abook_filter_model_freeze_refilter ()

void        osso_abook_filter_model_freeze_refilter
                                            (OssoABookFilterModel *model);

Freezes the filter. This means that any calls to osso_abook_filter_model_set_group() or osso_abook_filter_model_set_text() will not have any effect until osso_abook_filter_model_thaw_refilter() is called.

Use this function if you need to change the group and the text at the same time. The rows will then be refiltered only once.

osso_abook_filter_model_thaw_refilter ()

void        osso_abook_filter_model_thaw_refilter
                                            (OssoABookFilterModel *model);

Thaws the filter. See osso_abook_filter_model_freeze_refilter() for details.

osso_abook_filter_model_get_markup ()

PangoAttrList* osso_abook_filter_model_get_markup
                                            (OssoABookFilterModel *model,
                                             const char *text);

Generates a PangoAttrList containing markup information to highlight any found bits of the filter text in text.

osso_abook_filter_model_is_row_visible ()

gboolean    osso_abook_filter_model_is_row_visible
                                            (OssoABookFilterModel *model,
                                             GtkTreeIter *iter);

Determines whether the row indicated by iter is visible, i.e. satisfies the filter requirements.

The "base-model" property

  "base-model"           OssoABookTreeModel    : Read / Write / Construct Only

The contained OssoABookTreeModel.

The "group" property

  "group"                OssoABookGroup        : Read / Write

The group to be filtered on.

The "text" property

  "text"                 gchararray            : Read / Write

The text to be filtered on.

Default value: NULL