Class CIdleFinder

class CIdleFinder : public CIdle;

Description

Provides information about the progress of an asynchronous contact database search, and can be used to get the results of the search.

An instance of this class is returned by calls to CContactDatabase::FindAsyncL() and CContactDatabase::FindInTextDefAsyncL().

Derivation

• CBase - Base class for all classes to be instantiated on the heap
• CActive - The core class of the active object abstraction
• CIdle - An active object that performs low-priority processing when no higher-priority active objects are ready to run
• CIdleFinder - Provides information about the progress of an asynchronous contact database search, and can be used to get the results of the search

Members

Defined in CIdleFinder:
DoCancel(), Error(), IsComplete(), TakeContactIds()

Inherited from CActive:
Cancel(), Deque(), EPriorityHigh, EPriorityIdle, EPriorityLow, EPriorityStandard, EPriorityUserInput, Extension_(), IsActive(), IsAdded(), Priority(), RunError(), SetActive(), SetPriority(), TPriority, iStatus

Inherited from CBase:
Delete(), operator new()

Inherited from CIdle:
New(), NewL(), RunL(), Start(), iCallBack

IMPORT_C TBool IsComplete() const;

Description

Tests whether a search is complete. It should be used in an implementation of the callback function MIdleFindObserver::IdleFindCallback().

Return value

IMPORT_C CContactIdArray *TakeContactIds();

Description

Gives access to and takes ownership of the array of contact items found in the search.

Return value

IMPORT_C TInt Error() const;

Description

Checks for errors when the search is complete.

Return value

private: virtual void DoCancel();

Description

Implements cancellation of an outstanding request.

This function is called as part of the active object's Cancel().

It must call the appropriate cancel function offered by the active object's asynchronous service provider. The asynchronous service provider's cancel is expected to act immediately.

DoCancel() must not wait for event completion; this is handled by Cancel().

See also:

• CActive::Cancel