EDataBook.DataBookViewWatcherCache

Subclasses:

None

Methods

Inherited:

EBookContacts.BookIndicesUpdater (4), GObject.Object (37)

Structs:

GObject.ObjectClass (5)

class	new (backend, cache, view)
	dup_contacts (range_start, range_length)
	take_sort_fields (sort_fields)

Virtual Methods

Inherited:

GObject.Object (7)

Properties

None

Signals

Inherited:

GObject.Object (1)

Fields

Inherited:

GObject.Object (1)

Name	Type	Access	Description
parent	EBookContacts.BookIndicesUpdater	r

Class Details

class EDataBook.DataBookViewWatcherCache(**kwargs)

Bases:

EBookContacts.BookIndicesUpdater

Abstract:

No

Structure:

EDataBook.DataBookViewWatcherCacheClass

A structure used to handle “manual query” views for EDataBook.BookBackend descendants which use EDataBook.BookCache to store the contacts.

New in version 3.50.

classmethod new(backend, cache, view)

Parameters:

• backend (EDataBook.BookBackend) – an EDataBook.BookBackend

• cache (EDataBook.BookCache) – an EDataBook.BookCache

• view (EDataBook.DataBookView) – an EDataBook.DataBookView

Returns:

a new EDataBook.DataBookViewWatcherCache

Return type:

GObject.Object

Creates a new EDataBook.DataBookViewWatcherCache, which will watch the view and will provide the information about indices and total contacts to the backend, taking the data from the cache.

New in version 3.50.

dup_contacts(range_start, range_length)

Parameters:

• range_start (int) – range start, 0-based

• range_length (int) – how many contacts to retrieve

Returns:

an array of EBookContacts.Contact-s, or None, when range_start is out of bounds.

Return type:

[EBookContacts.Contact] or None

Retrieves contacts in the given range. Returns None when the range_start is out of bounds. The function can return less than range_length contacts.

The returned array should be freed with g_ptr_array_unref(), when no longer needed.

New in version 3.50.

take_sort_fields(sort_fields)

Parameters:

sort_fields (EBookContacts.BookClientViewSortFields or None) – an EBookContacts.BookClientViewSortFields, or None

Sets sort_fields as fields to sort the contacts by. If None, sorts by file-as field. The function assumes ownership of the sort_fields.

New in version 3.50.