Global Find Overview

Provides a simple interface which allows a caller to determine whether a text string appears in some part of a given message stored on an EPOC device.

The Global Find interface is supported by the Messaging Architecture and provides a framework which hides knowledge about message types from the caller. It hides the complexity of calling each client MTM’s implementation of CBaseMTM::Find(). MTM writers must correctly implement this function for Global Find to return useful results.

The API has 3 key concepts: The find operation, progress information, find text utility.

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.