Touch UI utilities API

The Touch UI utilities API is used for detecting long-tap events and showing an animation for them.

A long tap, also called a touch down and hold event, means that the user holds the stylus down on the screen at the same point for a long time.

Figure 1. Long-tap event used for opening a stylus pop-up menu

The Touch UI utilities API can be used in all GUI applications. It is a library API that provides an interface for constructing and using the long-tap detector component.

For user experience guidelines on the long-tap component, see Touch down and hold.

For the Touch UI utilities API classes and header files, see Classes and Definitions.

For implementation information, see Receiving long tap events.

Error handling

The leave mechanism of the Symbian platform environment is used for handling memory exhaustion.

Changes and release information

The Touch UI utilities API is an SDK API and first released in S60 5th Edition.

Constraints

This API is valid for all touch enabled Symbian platforms.

Emulator support

This API is fully supported in the WINS/WINSCW emulator environment.