Global find

The framework provides a simple interface which allows a caller to determine whether a text string appears in some part of a given message stored on a Symbian OS phone. The interface hides knowledge about message types from the caller, and the complexity of calling each client MTMs implementation of CBaseMTM::Find(). MTM writers must correctly implement this function for global find to return useful results.

Each find operation is associated with an instance of a CMsvFindOperation. An instance is created for each find operation to be performed, and destroyed when the operation is complete.

The scope of the find operation can be restricted to a selection of messages specified by the client and further limited to parts of those messages.

The find operation is asynchronous and can take time to complete. The API supplies progress information with sufficient detail to allow the client to drive a progress gauge.

The API also offers a useful utility for determining whether a text string exists within plain text or rich text.