class CIdleFinder : public CIdle |
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() .
Public Member Functions | |
---|---|
~CIdleFinder () | |
IMPORT_C TInt | Error () |
IMPORT_C TBool | IsComplete () |
TInt | RunError ( TInt ) |
IMPORT_C CContactIdArray * | TakeContactIds () |
Private Member Functions | |
---|---|
CIdleFinder ( CContactDatabase &, const CContactItemFieldDef *, const CContactTextDef *, MIdleFindObserver *) | |
TInt | CallbackL ( TAny *) |
TBool | CheckFindL ( TContactItemId ) |
TBool | CheckFindL () |
void | ConstructL (const TDesC *, const MDesCArray *, const TCallBack *) |
void | DoCancel () |
CIdleFinder * | NewL ( CContactDatabase &, const TDesC &, const CContactItemFieldDef *, MIdleFindObserver *) |
CIdleFinder * | NewL ( CContactDatabase &, const MDesCArray *, const CContactTextDef *, MIdleFindObserver *, const TCallBack &) |
TBool | ScanForMatchL (const TDesC &, const TDesC &, CFoundMatches *) |
void | Start () |
TBool | doFindL () |
Private Member Enumerations | |
---|---|
enum | TAsyncFindState { EFindInBlobFinished = 0x00000001, EFindInIdentityFinished = 0x00000002, EFindInEmailFinished = 0x00000004, EFindInTextDefFinished = 0x00000008 } |
Inherited Enumerations | |
---|---|
CActive:TPriority |
Inherited Attributes | |
---|---|
CActive::iStatus | |
CIdle::iCallBack |
CIdleFinder | ( | CContactDatabase & | aContactDatabase, |
const CContactItemFieldDef * | aFieldDef, | ||
const CContactTextDef * | aTextDef, | ||
MIdleFindObserver * | aObserver | ||
) | [private] |
CIdleFinder constructor.
CContactDatabase & aContactDatabase | |
const CContactItemFieldDef * aFieldDef | |
const CContactTextDef * aTextDef | |
MIdleFindObserver * aObserver |
TBool | CheckFindL | ( | TContactItemId | aContactId | ) | const [private] |
Use the client supplied "find words parser" to check for a match of the "find words" within the text fields in the given Contact Item.
TContactItemId aContactId |
void | ConstructL | ( | const TDesC * | aText, |
const MDesCArray * | aFindWords, | |||
const TCallBack * | aWordParserCallback | |||
) | [private] |
Initialise and start the asynchronous find.
void | DoCancel | ( | ) | [private, virtual] |
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() .
CIdleFinder * | NewL | ( | CContactDatabase & | aContactDatabase, |
const TDesC & | aText, | |||
const CContactItemFieldDef * | aFieldDef, | |||
MIdleFindObserver * | aObserver | |||
) | [private, static] |
CIdleFinder object factory. This form of NewL() should be used when performing an asynchronous find using text and a field definition.
CContactDatabase & aContactDatabase | |
const TDesC & aText | |
const CContactItemFieldDef * aFieldDef | |
MIdleFindObserver * aObserver |
CIdleFinder * | NewL | ( | CContactDatabase & | aContactDatabase, |
const MDesCArray * | aFindWords, | |||
const CContactTextDef * | aTextDef, | |||
MIdleFindObserver * | aObserver, | |||
const TCallBack & | aWordParserCallback | |||
) | [private, static] |
CIdleFinder object factory. This form of NewL() should be used when performing an asynchronous find using "find words"/"find words parser" and a text definition.
CContactDatabase & aContactDatabase | |
const MDesCArray * aFindWords | |
const CContactTextDef * aTextDef | |
MIdleFindObserver * aObserver | |
const TCallBack & aWordParserCallback |
TBool | ScanForMatchL | ( | const TDesC & | aFieldText, |
const TDesC & | aFindText, | |||
CFoundMatches * | aFoundMatches | |||
) | const [private] |
IMPORT_C CContactIdArray * | TakeContactIds | ( | ) |
Get and take ownership of the Contact IDs.
TBool | doFindL | ( | ) | [private] |
CIdle callback method. Makes an IPC call into the Server to perform a find iteration.
On return from the find iteration from the Server if "find words" were specified when initialising the find then the client supplied "find words parser" is invoked to search the returned Contact IDs. The search cannot be performed on the server because it is not possible to provide the client supplied callback to the server.
EFindInBlobFinished = 0x00000001 | |
EFindInIdentityFinished = 0x00000002 | |
EFindInEmailFinished = 0x00000004 | |
EFindInTextDefFinished = 0x00000008 |
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.