Protected C++ constructor.

Initialises the view's state to EInitializing.

Destructor.

Cancels all outstanding notifications and deletes all resources owned by the object.

Returns a descriptor containing the contents of all fields for an item in the view.

The field separator is used to separate the contents of each field. It is not appended to the last field.

Returns the contact item ID at the specified index into the view.

This is a reserved virtual exported function that is used for BC proofing against addition of new exported virtual functions. This function now aids addition of new exported virtual methods without having to break BC,by simply having those virtual methods as non-virtual and helper methods, called from this one and only reserved virtual exported method.A public enumeration type that is defined in the base class CContactViewBase identifies which of the helper 'virtual' methods are being called. All derived classes of CContactViewBase that are public should mandatorily implement this method.

Returns any return values of the helper methods called from this function.

Removes an observer from the view's observer array.

Any outstanding notifications for aObserver are first cancelled.

Used for view sorting and insersion. In order to give a stable result if contact details match, it falls back to comparing contact IDs. If a contact view sort plugin is loaded it uses its SortCompareViewContactsL() method.

Collates two contact items' field contents.

This is done by comparing each contact item on a field by field basis starting with the loosest collation level initially, and then progressing to tighter collation levels only if the items are considered the same at the looser level. This is required so that items differing by case only are sorted correctly. If a field isn't present, then the comparison is done using the first field that is present.

Protected second phase constructor.

Called from a derived class's ConstructL() . Creates the view's asynchronous notifier and adds it to the active scheduler.

Returns the contact item at the specified index into the view.

Asks the contact if it is sortable. 'static' function used by Sort Plugin.

Gets the view preferences.

Searches all contact items in the view for fields that contain all of the search strings specified.

The search uses wildcard matching so that the search strings can occur anywhere in the item's fields. For a match to occur, all of the search strings must be found in a contact item.

Searches all contact items in the view for fields that contain all of the search strings specified.

Unlike ContactsMatchingCriteriaL() , the search term can only occur at the beginning of a field.

Returns the number of contact items in the view.

Gets the recorded error value. If an error occurs within the view, before each of the views observers are notified, then the view records the error code internally. This function provides access to a copy of that error code.

Allocates and returns a descriptor filled with the contents of all the fields in a contact item.

The fields are separated by the specified separator.

Returns the index into the view of the specified contact item.

Gets an array containing the IDs of the contact items at the specified view indexes.

The IDs are appended to the array.

Gets an array containing the IDs of the contact items that match the filter supplied by the client.

Gets the UID of the view's find configuration plug-in, as set by SetViewFindConfigPlugin() .

CContactViewFindConfigInterface

Tests whether the IDs of two contact items are the same.

Tests whether the IDs of two contact items are the same.

Tests whether the view indexes of two contact items are the same.

Does a binary search of the contacts array, and inserts a new contact. Uses the current sort plugin, if any.

This function determines whether a contact should be added to the normal sorted array (iContacts) or put into the alternative iUnSortedContacts array. Depending on the view preferences, these "unsorted" contacts are either ignored (deleted), or added to the beginning or end of the iContacts sorted list by At(), Find() etc... methods.

Searches a single contact item for fields that contain one or more search strings.

The search uses wildcard matching so that the search strings can occur anywhere in any of the item's fields. For a match to occur, all of the search strings must be found in the contact item.

Any find configuration plug-in that has been set (by calling SetViewFindConfigPlugin() ) will be used.

Searches a single contact item for fields that contain one or more search strings.

The search type indicates whether the search strings can occur anywhere in a field, or must occur at the start of a field only. For a match to occur, all of the search strings must be found in the contact item.

This function does not use any find configuration plug-in that has been set (by calling SetViewFindConfigPlugin() ), so new code should use one of the other overloads instead. This function has been maintained for binary compatibility with previous OS versions.

Searches a single contact item for fields that contain one or more search strings.

The search type indicates whether the search strings can occur anywhere in a field, or must occur at the start of a field only. For a match to occur, all of the search strings must be found in the contact item.

If a find configuration plug-in UID is specified in the fourth parameter, this overload uses it, loading it first if necessary. This overrides any plug-in that had previously been set by a call to SetViewFindConfigPlugin() .

Called to notify a single view observer asynchronously of an event.

If other notifications are outstanding, this notification is appended to the queue.

If the view's asynchronous notifier is not active, it is started as a background task.

This function is called by OpenL() and Open() to notify the observer that the view is ready.

Called by derived view classes to notify their observers synchronously of an event, by calling their HandleContactViewEvent() function.

Appends an observer to the view's observer array.

If the view's state is EReady, the observer is notified asynchronously that the view is ready.

This function does not leave; an error code is returned instead.

Appends an observer to the view's observer array.

If the view's state is EReady, the observer is notified asynchronously that the view is ready.

An error causes the function to leave.

Sets the UID of the view's find configuration plug-in to use in calls to ContactsMatchingCriteriaL() , ContactsMatchingPrefixL() and MatchesCriteriaL() .

CContactViewFindConfigInterface

Gets the view's sort order.

Collates two contact items' field contents.

This is done by comparing each contact item on a field by field basis starting with the loosest collation level initially, and then progressing to tighter collation levels only if the items are considered the same at the looser level. This is required so that items differing by case only are sorted correctly. If a field isn't present, then the comparison is done using the first field that is present.

Faster than static CompareFieldsL() method as it uses prefetched collation method.

Identifies the functions that have been added to CContactViewBase , or that may be added in the future. This identifier is passed to the reserved virtual function CContactViewBase_Reserved_1() and enables the addition of new virtual methods without breaking binary compatibility.

Search type.

This controls whether a search term can occur anywhere in a contact item field, or just at the beginning of the field.

Defines the contact view states.