mainpage.dox

这个代码实现了从一段字符提取手机号码、email、url等信息的功能。这个是symbian下实现的。

/*! \mainpage FindItemTestApp Example
 *
 * \ref intro_sec
 * \n\ref Pre_sec
 * \n\ref Design_sec
 *
 * <HR>
 *
 * \section intro_sec 1. About this Example
 *
 *	FindItemTestApp is an example application that demonstrates Find Item API functionality. Find Item API offers methods for parsing phone numbers, e-mail addresses or URI addresses from given text.
 *
 *	 <HR>
 *
 * \section Pre_sec 2. Prerequisites
 *
 *	- Symbian 9.1 platform.
 *
 *	<HR>
 *
 *  \section Design_sec 3. Design and Implementation
 *
 *	FindItemTestApp is a simple Symbian Series 60 based UI application. <code>HandleCommandL</code> method of <code>CFindItemTestAppAppUI</code> class handles commands entered by user and directs the service requests to the right method that handles them.
 *
 *	The following sections explain the capabilities of the application, the current state of scalableUI support, the module dependencies and finally, steps required to build and use the application..
 *
 *  	\subsection Sub31 3.1 Capabilities
 *
 * 	The program capabilities are defined in %FindItemTestApp.mmp file: CAPABILITY NONE
 *
 *	\subsection Sub32 3.2 ScalableUI
 *
 *	The program takes screen parameters in the start of the application. The program does not support changing the screen layout while the program is running.
 *
 *	\subsection Sub33 3.3 Module dependencies
 *
 *	At build time there exists following module dependencies:
 *	- <em>FindItemTestApp</em> requires <em>CommonEngine.lib</em> because the Find Item API is a part of the CommonEngine.
 *
 *	In addition, several UI related libraries provided by SDK are required: euser, apparc, cone, eikcore, eikcoctl, avkon, efsrv, CommonEngine, bafl.
 *
 *	\subsection Sub34 3.4 Building the example application
 *
 *	Application can be built in directory <code>FindItemTestApp\\group</code> by running the following commands:
 *	- <code>bldmake bldfiles</code>
 *	- <code>abld build winscw udeb</code>
 *
 *	In addition it is possible to create project from <em>CodeWarrior</em> IDE by running the following command:
 *	- <code>abld makefile cw_ide</code>
 *
 *	After succesful build, application can be found and started from
 *	- <b>Applications > Installed > FindItemTestApp</b>.
 *
 *	\subsection Sub35 3.5 Using the application
 *
 *	In the following is described a typical use case scenario for the FindItemTestApp application. The scenario is as follows:
 *
 *	- User starts the application
 *	- User selects example text
 *	- User searches phone numbers
 *	- User searches mail addresses
 *	- User searches URIs
 *	- User searches URLs
 *	- User searches all items
 *	- User exits from the application
 *
 *	The rest of the sub sections describe how individual scenario steps are performed.
 *
 *	\subsubsection Subsub351 3.5.1 Select example text
 *
 *	After starting the application, there is an instructions displayed on the screen.
 * 	Select <b>Options > Example text</b> to view the example text.<br>
 *	By selecting <b>Back</b>, the user returns to instructions view.
 *
<img src="instructions.jpg"><h5 align="center">Figure 1 Application's instructions</h5></img>
<img src="optionlist.jpg"><h5 align="center">Figure 2 Opened optionlist</h5></img>
<img src="example_text.jpg"><h5 align="center">Figure 3 The example text</h5></img>
 *
 *	\subsubsection Subsub352 3.5.2 Search items
 *
 *	Select <b>Options > Search phone numbers / Search mail addresses / Search URIs / Search URLs / Saerch all items</b> to view the results of the wanted search.<br>
 *	By selecting <b>Back</b>, the user returns to instructions view.
 *
<img src="found_phone_numbers.jpg"><h5 align="center">Figure 4 Found phone numbers</h5></img>
<img src="found_uris.jpg"><h5 align="center">Figure 5 Found URIs</h5></img>
<img src="found_all_items.jpg"><h5 align="center">Figure 6 Found all items</h5></img>
 *
 *	\subsubsection Subsub353 3.5.3 Exiting from the application
 *
 *	By selecting <b>Options > Exit</b> in the instructions view, the user exits the application.
 *
 */