BookCache.full


Description:

[ CCode ( has_construct_function = false ) ]
public BookCache.full (string filename, Source? source, SourceBackendSummarySetup? setup, Cancellable? cancellable = null) throws Error

Creates a new BookCache with the given or the default summary configuration.

Like BookSqlite, but allows configuration of which contact fields will be stored for quick reference in the summary. The configuration indicated by setup will only be taken into account when initially creating the underlying table, further configurations will be ignored.

The fields e_contact_uid and e_contact_rev are not optional, they will be stored in the summary regardless of this function's parameters. Only ContactFields with the type g_type_string, g_type_boolean or e_type_contact_attr_list are currently supported.

Parameters:

filename

file name to load or create the new cache

source

an optional Source, associated with the BookCache, or null

setup

an SourceBackendSummarySetup describing how the summary should be setup, or null to use the default

cancellable

optional Cancellable object, or null

Returns:

A new BookCache or null on error