Collapse all Symbian^3 Product Developer Library

Query input

Query input is a full screen component for displaying data query with direct possibility for touch input. It uses the full screen. It is a standalone component from input methods and thus user cannot change the input method from the Query input.

In addition to data query content, it has Backspace button and ITU-T keypad buttons. Softkeys are also displayed as buttons next to the editor, instead of Control pane. This component is used for (PIN, PUK, time and date) queries in start-up, and also in password editors.

Prompt text can be displayed in three lines, for example, “PIN code blocked” and “Enter PIN code”, and is always aligned close to input field.

Figure 1. Example of alpha-numeric input mode in portrait and landscape.

If only number entry is enabled, the Query input displays number buttons.

Figure 2. Example of numeric input mode in portrait and landscape.

In other data queries, the touch input is opened with touch down and release to the editor. In query input, the input is instantly available for immediate usage. Some buttons may be dimmed if needed. Both portrait and landscape orientations are available for Query input.

Tactile feedback follows the virtual ITU-T feedback.

The following table lists the default touch events for query input:

Table 1. The default touch events for query input
User action	State change	Feedback
Touch down and release on left softkey.	Confirms the query. It is initially dimmed and changed active when first character is entered.	Tactile: Basic button effect and audio feedback are provided with touch down and basic button effect with release events.
Touch down and release on right softkey.	Cancels the query.	Tactile: Basic button effect and audio feedback are provided with touch down and basic button effect with release events.

Parent topic: Queries