Symbian3/PDK/Source/GUID-2E0F793F-3D80-4303-AF48-C7341F417DC9.dita
changeset 5 f345bda72bc4
child 9 59758314f811
equal deleted inserted replaced
4:4816d766a08a 5:f345bda72bc4
       
     1 <?xml version="1.0" encoding="utf-8"?>
       
     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
       
     3 <!-- This component and the accompanying materials are made available under the terms of the License 
       
     4 "Eclipse Public License v1.0" which accompanies this distribution, 
       
     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
       
     6 <!-- Initial Contributors:
       
     7     Nokia Corporation - initial contribution.
       
     8 Contributors: 
       
     9 -->
       
    10 <!DOCTYPE concept
       
    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
       
    12 <concept id="GUID-2E0F793F-3D80-4303-AF48-C7341F417DC9" xml:lang="en"><title>Editing
       
    13 menu</title><prolog><metadata><keywords/></metadata></prolog><conbody>
       
    14 <p>Users can access editing functions using the editing menu. It is opened
       
    15 by a short press of the star (*) key (or by pressing the Edit key on some
       
    16 devices) when in a text editor. The editing menu looks and functions like
       
    17 the <uicontrol>Options</uicontrol> menu, but it contains only text editing
       
    18 functions, whereas other available options remain accessible from the <uicontrol>Options</uicontrol> menu.
       
    19 The following table describes the options in the editing menu.</p>
       
    20 <note><p>Only items that apply to the editor in use appear in the menu.</p></note>
       
    21 <table id="GUID-45970160-E5B3-4C8D-8552-21683CA99EA5"><title>Editing menu
       
    22 options</title>
       
    23 <tgroup cols="2">
       
    24 
       
    25 <colspec colname="col1" colwidth="0.49*"/><colspec colname="col2" colwidth="1.51*"/>
       
    26 <thead>
       
    27 <row>
       
    28 <entry><p>Function</p></entry>
       
    29 <entry><p>Description</p></entry>
       
    30 </row>
       
    31 </thead>
       
    32 <tbody>
       
    33 <row>
       
    34 <entry><p>Special character row</p></entry>
       
    35 <entry><p>One row with the most used special characters and symbols.</p></entry>
       
    36 </row>
       
    37 <row>
       
    38 <entry><p>More symbols</p></entry>
       
    39 <entry><p>Opens a full grid of special characters and symbols.</p></entry>
       
    40 </row>
       
    41 <row>
       
    42 <entry><p>Predictive text</p></entry>
       
    43 <entry><p>Opens a submenu for the <uicontrol>Predictive text</uicontrol> options.</p><note><p>Some
       
    44 devices may offer more advanced text input methods and editing options.</p></note></entry>
       
    45 </row>
       
    46 <row>
       
    47 <entry><p>Matches</p></entry>
       
    48 <entry><p>Displays list of matched words when predictive text mode is on and
       
    49 a word is active in the editor.</p></entry>
       
    50 </row>
       
    51 <row>
       
    52 <entry><p>Insert word</p></entry>
       
    53 <entry><p>Opens a query for inserting a word (no prediction).</p></entry>
       
    54 </row>
       
    55 <row>
       
    56 <entry><p>Edit word</p></entry>
       
    57 <entry><p>In prediction mode, opens the active word from the editor in a query
       
    58 window for editing.</p></entry>
       
    59 </row>
       
    60 <row>
       
    61 <entry><p>Prediction on/off</p></entry>
       
    62 <entry><p>A temporary setting for predictive input.</p></entry>
       
    63 </row>
       
    64 <row>
       
    65 <entry><p>Alpha mode</p></entry>
       
    66 <entry><p>Switches to the alpha input mode.</p></entry>
       
    67 </row>
       
    68 <row>
       
    69 <entry><p>Number mode</p></entry>
       
    70 <entry><p>Switches to the number input mode.</p></entry>
       
    71 </row>
       
    72 <row>
       
    73 <entry><p>Copy text</p></entry>
       
    74 <entry><p>Starts text copying.</p></entry>
       
    75 </row>
       
    76 <row>
       
    77 <entry><p>Cut text</p></entry>
       
    78 <entry><p>Starts text cutting.</p></entry>
       
    79 </row>
       
    80 <row>
       
    81 <entry><p>Paste</p></entry>
       
    82 <entry><p>Pastes cut or copied text in the cursor position.</p></entry>
       
    83 </row>
       
    84 <row>
       
    85 <entry><p>Writing language</p></entry>
       
    86 <entry><p>Affects key mappings and predictive input.</p></entry>
       
    87 </row>
       
    88 </tbody>
       
    89 </tgroup>
       
    90 </table>
       
    91 <fig id="GUID-BA63E34E-A9CC-4A3C-836C-D4FED97A53B8">
       
    92 <title>Editing menu</title>
       
    93 <image href="GUID-722FAAAD-AD14-4139-857E-83B639FDEB58_d0e98181_href.png" placement="inline"/>
       
    94 </fig>
       
    95 <table id="GUID-18C61493-9C80-470A-B0C2-A419F55A15EC"><title>Default touch
       
    96 events in editor</title>
       
    97 <tgroup cols="3">
       
    98 
       
    99 <colspec colname="col1" colwidth="0.61*"/><colspec colname="col2" colwidth="1.28*"/>
       
   100 <colspec colname="col3" colwidth="1.12*"/>
       
   101 <thead>
       
   102 <row>
       
   103 <entry valign="top"><p>User action</p></entry>
       
   104 <entry valign="top"><p>State change</p></entry>
       
   105 <entry valign="top"><p>Feedback</p></entry>
       
   106 </row>
       
   107 </thead>
       
   108 <tbody>
       
   109 <row>
       
   110 <entry><p>Touch down</p></entry>
       
   111 <entry><p>Cursor is moved to the touch down position in the text field.</p></entry>
       
   112 <entry><p>Visual indication of touched down state </p><p>Tactile: Sensitive
       
   113 edit effect and audio feedback is provided with touch down event.</p></entry>
       
   114 </row>
       
   115 <row>
       
   116 <entry><p>Touch release</p></entry>
       
   117 <entry><p>Touch Input window is launched.</p></entry>
       
   118 <entry><p>Tactile: Sensitive edit effect is provided with touch release event.
       
   119 No audio feedback is provided.</p></entry>
       
   120 </row>
       
   121 <row>
       
   122 <entry><p>Touch down and drag</p></entry>
       
   123 <entry><ul>
       
   124 <li><p>A block of text is selected. Touch down, drag and touch release is
       
   125 performed in the text area. </p></li>
       
   126 <li><p>The text remains selected after touch release. </p></li>
       
   127 <li><p>Touch down a second time cancels the previous text selection and cursor
       
   128 is moved to the touch down position.</p></li>
       
   129 </ul></entry>
       
   130 <entry><p>Tactile: <ul>
       
   131 <li><p>Sensitive edit and audio feedback is provided with touch down event.</p></li>
       
   132 <li><p>Text edit and audio feedback effect is provided while selecting letters. </p></li>
       
   133 <li><p>Blank edit effect given while selecting blank space.</p></li>
       
   134 <li><p>Line edit and audio feedback is provided while selecting lines.</p></li>
       
   135 <li><p>Empty line effect is provided while selecting empty line.</p></li>
       
   136 <li><p>Pop-up open effect is provided with touch down after selecting.</p></li>
       
   137 </ul> </p></entry>
       
   138 </row>
       
   139 <row>
       
   140 <entry><p>Touch down and drag outside</p></entry>
       
   141 <entry><ul>
       
   142 <li><p>Scrolling of text that did not fit in the edit area. </p></li>
       
   143 <li><p>A block of text is selected. </p></li>
       
   144 <li><p>Touch down and drag to out of the text field if there is text that
       
   145 can be scrolled, else no action.</p></li>
       
   146 </ul></entry>
       
   147 <entry><p>Tactile: Sensitive edit and audio feedback given with touch down
       
   148 effect. Specific effect given while selecting, see previous row.</p></entry>
       
   149 </row>
       
   150 </tbody>
       
   151 </tgroup>
       
   152 </table>
       
   153 <p/>
       
   154 <table id="GUID-59AD9052-3167-411D-B8D4-549F6DAD7C69"><title>Default touch
       
   155 events in editor with kinetic scrolling when no text is selected</title>
       
   156 <tgroup cols="3">
       
   157 
       
   158 <colspec colname="col1" colwidth="0.61*"/><colspec colname="col2" colwidth="1.27*"/>
       
   159 <colspec colname="col3" colwidth="1.13*"/>
       
   160 <thead>
       
   161 <row>
       
   162 <entry valign="top"><p>User action</p></entry>
       
   163 <entry valign="top"><p>State change</p></entry>
       
   164 <entry valign="top"><p>Feedback</p></entry>
       
   165 </row>
       
   166 </thead>
       
   167 <tbody>
       
   168 <row>
       
   169 <entry><p>Touch down</p></entry>
       
   170 <entry><p>No change</p></entry>
       
   171 <entry><p>Tactile: Sensitive edit effect and audio feedback is provided with
       
   172 touch down event.</p></entry>
       
   173 </row>
       
   174 <row>
       
   175 <entry><p>Touch release</p></entry>
       
   176 <entry><ul>
       
   177 <li><p>Cursor is moved to the touch down position in the text field. </p></li>
       
   178 <li><p>Touch Input window is launched.</p></li>
       
   179 <li><p>In viewer: Inactive</p></li>
       
   180 </ul></entry>
       
   181 <entry><p>Tactile: Sensitive edit effect is provided with touch release event.
       
   182 No audio feedback is provided.</p></entry>
       
   183 </row>
       
   184 <row>
       
   185 <entry><p>Touch down, move horizontally and release</p></entry>
       
   186 <entry><ul>
       
   187 <li><p>A block of text is selected. </p></li>
       
   188 <li><p>Touch down, drag and touch release is performed in the text area. </p></li>
       
   189 <li><p>The text remains selected after touch release. </p></li>
       
   190 <li><p>In viewer: Opens stylus pop-up menu with available CCP menu options
       
   191 after touch release.</p></li>
       
   192 </ul></entry>
       
   193 <entry><p>Tactile: <ul>
       
   194 <li><p>Sensitive edit and audio feedback is provided with touch down event.</p></li>
       
   195 <li><p>Text edit and audio feedback effect is provided while selecting letters.</p></li>
       
   196 <li><p>Blank edit effect is provided while selecting blank space.</p></li>
       
   197 </ul></p></entry>
       
   198 </row>
       
   199 <row>
       
   200 <entry><p>Touch down, move horizontally, then move vertically without lifting
       
   201 finger and release</p></entry>
       
   202 <entry><ul>
       
   203 <li><p>A block of text is selected. </p></li>
       
   204 <li><p>Touch down, drag and touch release is performed in the text area. </p></li>
       
   205 <li><p>The text remains selected after touch release. </p></li>
       
   206 <li><p>In viewer: Opens stylus pop-up menu with available CCP menu options
       
   207 after touch release.</p></li>
       
   208 </ul></entry>
       
   209 <entry><p>Tactile: <ul>
       
   210 <li><p>Sensitive edit and audio feedback is provided with touch down event.</p></li>
       
   211 <li><p>Text edit and audio feedback effect is provided while selecting letters.</p></li>
       
   212 <li><p>Blank edit effect is provided while selecting blank space.</p></li>
       
   213 <li><p>Line edit and audio feedback is provided while selecting lines.</p></li>
       
   214 <li><p>Empty line effect is provided while selecting empty line.</p></li>
       
   215 </ul> </p></entry>
       
   216 </row>
       
   217 <row>
       
   218 <entry><p>Touch down, move horizontally, then release with speed</p></entry>
       
   219 <entry><ul>
       
   220 <li><p>A block of text is selected. </p></li>
       
   221 <li><p>Touch down, drag and touch release is performed in the text area. </p></li>
       
   222 <li><p>The text remains selected after touch release. </p></li>
       
   223 <li><p>Flick not applicable.</p></li>
       
   224 </ul></entry>
       
   225 <entry><p>Tactile: <ul>
       
   226 <li><p>Sensitive edit and audio feedback is provided with touch down event.</p></li>
       
   227 <li><p>Text edit and audio feedback effect is provided while selecting letters.</p></li>
       
   228 <li><p>Blank edit effect is provided while selecting blank space.</p></li>
       
   229 <li><p>Line edit and audio feedback is provided while selecting lines.</p></li>
       
   230 <li><p>Empty line effect is provided while selecting empty line.</p></li>
       
   231 </ul> </p></entry>
       
   232 </row>
       
   233 <row>
       
   234 <entry><p>Touch down and move outside</p></entry>
       
   235 <entry><ul>
       
   236 <li><p>Scrolling of text that did not fit in the edit area. </p></li>
       
   237 <li><p>A block of text is selected.</p></li>
       
   238 <li><p>Touch down and drag to out of the text field. </p></li>
       
   239 <li><p>This is if there is text that can be scrolled, otherwise no action.</p></li>
       
   240 </ul></entry>
       
   241 <entry><p>Tactile: <ul>
       
   242 <li><p>Sensitive edit and audio feedback is provided with touch down effect.</p></li>
       
   243 <li><p> Specific effect given while selecting, see previous row.</p></li>
       
   244 </ul></p></entry>
       
   245 </row>
       
   246 <row>
       
   247 <entry><p>Touch down, move vertically and release</p></entry>
       
   248 <entry><ul>
       
   249 <li><p>Scrolling stops on release, no text is selected. </p></li>
       
   250 <li><p>Cursor is moved on touch down after a certain threshold. </p></li>
       
   251 <li><p>It is not immediately moved to avoid cursor jumping during dragging
       
   252 and flicking. </p></li>
       
   253 <li><p>No cursor is shown during scrolling. Cursor is not moved on release.</p></li>
       
   254 </ul></entry>
       
   255 <entry/>
       
   256 </row>
       
   257 <row>
       
   258 <entry><p>Touch down, move vertically and release with speed</p></entry>
       
   259 <entry><ul>
       
   260 <li><p>Scrolling continues on flick speed and slows down (kinetic).</p></li>
       
   261 <li><p>Scrolling is stopped when speed slows down or end of text is reached.</p></li>
       
   262 <li><p>Boundary effect is given at the end of text. No text is selected.</p></li>
       
   263 </ul><p>Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging
       
   264 and flicking</xref> events.</p></entry>
       
   265 <entry><p>Tactile: Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging
       
   266 and flicking</xref> events.</p></entry>
       
   267 </row>
       
   268 <row>
       
   269 <entry><p>Touch down and hold and touch release</p></entry>
       
   270 <entry><p>Inactive</p></entry>
       
   271 <entry><p>No effect</p></entry>
       
   272 </row>
       
   273 </tbody>
       
   274 </tgroup>
       
   275 </table>
       
   276 <p/>
       
   277 <table id="GUID-72478E61-B2A4-4A0E-A0E2-50DCDC735ABB"><title>Default touch
       
   278 events in editor when text is selected</title>
       
   279 <tgroup cols="3">
       
   280 
       
   281 <colspec colname="col1" colwidth="0.61*"/><colspec colname="col2" colwidth="1.26*"/>
       
   282 <colspec colname="col3" colwidth="1.13*"/>
       
   283 <thead>
       
   284 <row>
       
   285 <entry valign="top"><p>User action</p></entry>
       
   286 <entry valign="top"><p>State change</p></entry>
       
   287 <entry valign="top"><p>Feedback</p></entry>
       
   288 </row>
       
   289 </thead>
       
   290 <tbody>
       
   291 <row>
       
   292 <entry><p>Touch down and release</p></entry>
       
   293 <entry><ul>
       
   294 <li><p>When touch down and release out of the selection, highlight disappears
       
   295 and cursor stays where it was. </p></li>
       
   296 <li><p>In viewers: Highlight disappears.</p></li>
       
   297 <li><p>When touch down and release within selected text, opens virtual input,
       
   298 highlight stays as it is and can be modified in input editor. </p></li>
       
   299 <li><p>In viewers: Inactive.</p></li>
       
   300 </ul></entry>
       
   301 <entry><p>Tactile: Sensitive edit effect and audio feedback is provided with
       
   302 touch down event.</p></entry>
       
   303 </row>
       
   304 <row>
       
   305 <entry><p>Touch down and hold</p></entry>
       
   306 <entry><p>Inactive</p></entry>
       
   307 <entry><p>No effect</p></entry>
       
   308 </row>
       
   309 <row>
       
   310 <entry><p>Touch down and move horizontally</p></entry>
       
   311 <entry><ul>
       
   312 <li><p>When on selected text, the beginning or ending point of the selection
       
   313 follows the finger and the selection changes dynamically. </p></li>
       
   314 <li><p>Touch down, drag and touch release is performed in the text area. </p></li>
       
   315 <li><p>The text remains selected after touch release. </p></li>
       
   316 <li><p>When touch down and move horizontally outside the text selection, behavior
       
   317 is inactive.</p></li>
       
   318 </ul></entry>
       
   319 <entry><p>Tactile: <ul>
       
   320 <li><p>Sensitive edit and audio feedback is provided with touch down event.</p></li>
       
   321 <li><p>Text edit and audio feedback effect is provided while selecting letters.</p></li>
       
   322 <li><p>Blank edit effect is provided while selecting blank space.</p></li>
       
   323 <li><p>Line edit and audio feedback is provided while selecting lines. </p></li>
       
   324 <li><p>Empty line effect is provided while selecting empty line.</p></li>
       
   325 <li><p>Pop-up open effect given with touch down after selecting.</p></li>
       
   326 </ul> </p></entry>
       
   327 </row>
       
   328 <row>
       
   329 <entry><p>Touch down, move horizontally and release with speed</p></entry>
       
   330 <entry><ul>
       
   331 <li><p>When on selected text, the beginning or ending point of the selection
       
   332 follows the finger and the selection changes dynamically during the drag. </p></li>
       
   333 <li><p>Release with speed is disabled. Touch down, move and touch release
       
   334 is performed in the text area. </p></li>
       
   335 <li><p>The text remains selected after touch release up to the point of the
       
   336 release. </p></li>
       
   337 <li><p>When touch down and move horizontally outside the text selection, behavior
       
   338 is inactive.</p></li>
       
   339 </ul></entry>
       
   340 <entry/>
       
   341 </row>
       
   342 <row>
       
   343 <entry><p>Touch down, move vertically and release</p></entry>
       
   344 <entry><ul>
       
   345 <li><p>When on selected text, the beginning or ending point of the selection
       
   346 follows the finger and the selection changes dynamically during the drag. </p></li>
       
   347 <li><p>Release with speed is disabled. </p></li>
       
   348 <li><p>Touch down, move and touch release is performed in the text area. </p></li>
       
   349 <li><p>On touch release the text remains selected. </p></li>
       
   350 <li><p>When touch down and move vertically outside selected text, content
       
   351 moves with finger. </p></li>
       
   352 <li><p>On touch release content movement stops and text remains selected.</p></li>
       
   353 </ul></entry>
       
   354 <entry/>
       
   355 </row>
       
   356 <row>
       
   357 <entry><p>Touch down and move vertically and release</p></entry>
       
   358 <entry><ul>
       
   359 <li><p>Content movement stops when dragging was in effect. </p></li>
       
   360 <li><p>Text remains selected.</p></li>
       
   361 </ul></entry>
       
   362 <entry/>
       
   363 </row>
       
   364 <row>
       
   365 <entry><p>Touch down, move vertically and release with speed</p></entry>
       
   366 <entry><p>Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging
       
   367 and flicking</xref> events.</p><p>Text remains selected.</p></entry>
       
   368 <entry/>
       
   369 </row>
       
   370 <row>
       
   371 
       
   372 <entry><p>Touch down and move outside</p></entry>
       
   373 <entry><ul>
       
   374 <li><p>Scrolling of text that did not fit in the edit area. </p></li>
       
   375 <li><p>A block of text is selected. </p></li>
       
   376 <li><p>Touch down and drag to out of the text field if there
       
   377 is text that can be scrolled, else no action.</p></li>
       
   378 </ul></entry>
       
   379 <entry><p>Tactile: <ul>
       
   380 <li><p>Sensitive edit and audio feedback is provided with touch down effect.</p></li>
       
   381 <li><p>Specific effect given while selecting, see row 3.</p></li>
       
   382 </ul> </p></entry>
       
   383 </row>
       
   384 <row>
       
   385 <entry><p>Touch down outside highlighted text and move horizontally</p></entry>
       
   386 <entry><p>Editors and viewers: When dragging starts, highlight disappears
       
   387 from previous place and starts highlighting new text with the horizontal move.</p></entry>
       
   388 <entry/>
       
   389 </row>
       
   390 </tbody>
       
   391 </tgroup>
       
   392 </table></conbody></concept>