S60 3rd Edition SDK for Symbian OS
Example Applications Guide

FindItemTestApp Example

1. About this Example
2. Prerequisites
3. Design and Implementation
4. Class List

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.

FindItemTestApp is a simple Symbian Series 60 based UI application. HandleCommandL method of CFindItemTestAppAppUI 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..

3.1 Capabilities

The program capabilities are defined in FindItemTestApp.mmp file: CAPABILITY NONE

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.

3.3 Module dependencies

At build time there exists following module dependencies:

FindItemTestApp requires CommonEngine.lib 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.

3.4 Building the example application

Application can be built in directory FindItemTestApp\group by running the following commands:

bldmake bldfiles
abld build winscw udeb

In addition it is possible to create project from CodeWarrior IDE by running the following command:

abld makefile cw_ide

After succesful build, application can be found and started from

Applications > Installed > FindItemTestApp.

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.

3.5.1 Select example text

After starting the application, there is an instructions displayed on the screen. Select Options > Example text to view the example text.
By selecting Back, the user returns to instructions view.

Figure 1 Application's instructions

Figure 2 Opened optionlist

Figure 3 The example text

3.5.2 Search items

Select Options > Search phone numbers / Search mail addresses / Search URIs / Search URLs / Saerch all items to view the results of the wanted search.
By selecting Back, the user returns to instructions view.

Figure 4 Found phone numbers

Figure 5 Found URIs

Figure 6 Found all items

3.5.3 Exiting from the application

By selecting Options > Exit in the instructions view, the user exits the application.

4. Class List

Here are the classes, structs, unions and interfaces with brief descriptions:

This inheritance list is sorted roughly, but not completely, alphabetically: