Collapse all Symbian^3 Application Developer Library

Editing menu

Users can access editing functions using the editing menu. It is opened by a short press of the star (*) key (or by pressing the Edit key on some devices) when in a text editor. The editing menu looks and functions like the Options menu, but it contains only text editing functions, whereas other available options remain accessible from the Options menu. The following table describes the options in the editing menu.

Note:

Only items that apply to the editor in use appear in the menu.

Table 1. Editing menu options
Function	Description
Special character row	One row with the most used special characters and symbols.
More symbols	Opens a full grid of special characters and symbols.
Predictive text	Opens a submenu for the Predictive text options. Note: Some devices may offer more advanced text input methods and editing options.
Matches	Displays list of matched words when predictive text mode is on and a word is active in the editor.
Insert word	Opens a query for inserting a word (no prediction).
Edit word	In prediction mode, opens the active word from the editor in a query window for editing.
Prediction on/off	A temporary setting for predictive input.
Alpha mode	Switches to the alpha input mode.
Number mode	Switches to the number input mode.
Copy text	Starts text copying.
Cut text	Starts text cutting.
Paste	Pastes cut or copied text in the cursor position.
Writing language	Affects key mappings and predictive input.

Figure 1. Editing menu

Table 2. Default touch events in editor
User action	State change	Feedback
Touch down	Cursor is moved to the touch down position in the text field.	Visual indication of touched down state Tactile: Sensitive edit effect and audio feedback is provided with touch down event.
Touch release	Touch Input window is launched.	Tactile: Sensitive edit effect is provided with touch release event. No audio feedback is provided.
Touch down and drag	A block of text is selected. Touch down, drag and touch release is performed in the text area. The text remains selected after touch release. Touch down a second time cancels the previous text selection and cursor is moved to the touch down position.	Tactile: Sensitive edit and audio feedback is provided with touch down event. Text edit and audio feedback effect is provided while selecting letters. Blank edit effect given while selecting blank space. Line edit and audio feedback is provided while selecting lines. Empty line effect is provided while selecting empty line. Pop-up open effect is provided with touch down after selecting.
Touch down and drag outside	Scrolling of text that did not fit in the edit area. A block of text is selected. Touch down and drag to out of the text field if there is text that can be scrolled, else no action.	Tactile: Sensitive edit and audio feedback given with touch down effect. Specific effect given while selecting, see previous row.

Table 3. Default touch events in editor with kinetic scrolling when no text is selected
User action	State change	Feedback
Touch down	No change	Tactile: Sensitive edit effect and audio feedback is provided with touch down event.
Touch release	Cursor is moved to the touch down position in the text field. Touch Input window is launched. In viewer: Inactive	Tactile: Sensitive edit effect is provided with touch release event. No audio feedback is provided.
Touch down, move horizontally and release	A block of text is selected. Touch down, drag and touch release is performed in the text area. The text remains selected after touch release. In viewer: Opens stylus pop-up menu with available CCP menu options after touch release.	Tactile: Sensitive edit and audio feedback is provided with touch down event. Text edit and audio feedback effect is provided while selecting letters. Blank edit effect is provided while selecting blank space.
Touch down, move horizontally, then move vertically without lifting finger and release	A block of text is selected. Touch down, drag and touch release is performed in the text area. The text remains selected after touch release. In viewer: Opens stylus pop-up menu with available CCP menu options after touch release.	Tactile: Sensitive edit and audio feedback is provided with touch down event. Text edit and audio feedback effect is provided while selecting letters. Blank edit effect is provided while selecting blank space. Line edit and audio feedback is provided while selecting lines. Empty line effect is provided while selecting empty line.
Touch down, move horizontally, then release with speed	A block of text is selected. Touch down, drag and touch release is performed in the text area. The text remains selected after touch release. Flick not applicable.	Tactile: Sensitive edit and audio feedback is provided with touch down event. Text edit and audio feedback effect is provided while selecting letters. Blank edit effect is provided while selecting blank space. Line edit and audio feedback is provided while selecting lines. Empty line effect is provided while selecting empty line.
Touch down and move outside	Scrolling of text that did not fit in the edit area. A block of text is selected. Touch down and drag to out of the text field. This is if there is text that can be scrolled, otherwise no action.	Tactile: Sensitive edit and audio feedback is provided with touch down effect. Specific effect given while selecting, see previous row.
Touch down, move vertically and release	Scrolling stops on release, no text is selected. Cursor is moved on touch down after a certain threshold. It is not immediately moved to avoid cursor jumping during dragging and flicking. No cursor is shown during scrolling. Cursor is not moved on release.
Touch down, move vertically and release with speed	Scrolling continues on flick speed and slows down (kinetic). Scrolling is stopped when speed slows down or end of text is reached. Boundary effect is given at the end of text. No text is selected. Refer to Dragging and flicking events.	Tactile: Refer to Dragging and flicking events.
Touch down and hold and touch release	Inactive	No effect

Table 4. Default touch events in editor when text is selected
User action	State change	Feedback
Touch down and release	When touch down and release out of the selection, highlight disappears and cursor stays where it was. In viewers: Highlight disappears. When touch down and release within selected text, opens virtual input, highlight stays as it is and can be modified in input editor. In viewers: Inactive.	Tactile: Sensitive edit effect and audio feedback is provided with touch down event.
Touch down and hold	Inactive	No effect
Touch down and move horizontally	When on selected text, the beginning or ending point of the selection follows the finger and the selection changes dynamically. Touch down, drag and touch release is performed in the text area. The text remains selected after touch release. When touch down and move horizontally outside the text selection, behavior is inactive.	Tactile: Sensitive edit and audio feedback is provided with touch down event. Text edit and audio feedback effect is provided while selecting letters. Blank edit effect is provided while selecting blank space. Line edit and audio feedback is provided while selecting lines. Empty line effect is provided while selecting empty line. Pop-up open effect given with touch down after selecting.
Touch down, move horizontally and release with speed	When on selected text, the beginning or ending point of the selection follows the finger and the selection changes dynamically during the drag. Release with speed is disabled. Touch down, move and touch release is performed in the text area. The text remains selected after touch release up to the point of the release. When touch down and move horizontally outside the text selection, behavior is inactive.
Touch down, move vertically and release	When on selected text, the beginning or ending point of the selection follows the finger and the selection changes dynamically during the drag. Release with speed is disabled. Touch down, move and touch release is performed in the text area. On touch release the text remains selected. When touch down and move vertically outside selected text, content moves with finger. On touch release content movement stops and text remains selected.
Touch down and move vertically and release	Content movement stops when dragging was in effect. Text remains selected.
Touch down, move vertically and release with speed	Refer to Dragging and flicking events. Text remains selected.
Touch down and move outside	Scrolling of text that did not fit in the edit area. A block of text is selected. Touch down and drag to out of the text field if there is text that can be scrolled, else no action.	Tactile: Sensitive edit and audio feedback is provided with touch down effect. Specific effect given while selecting, see row 3.
Touch down outside highlighted text and move horizontally	Editors and viewers: When dragging starts, highlight disappears from previous place and starts highlighting new text with the horizontal move.

Parent topic: Text editing