annotate help/VirtualKeyboard.html.in @ 527:9e9d6eb9a9c4

Added tag stable-1.9.4-8 for changeset 9a8862b87f6e
author Carl Byington <carl@five-ten-sg.com>
date Sat, 01 Jun 2024 10:41:51 -0600
parents 95188bd4badb
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
360
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
1 <h2>Virtual Keyboard</h2>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
2
381
95188bd4badb cleanup help pages
Carl Byington <carl@five-ten-sg.com>
parents: 360
diff changeset
3 <p>Since ConnectBot doesn&apos;t use any of the normal TextView
95188bd4badb cleanup help pages
Carl Byington <carl@five-ten-sg.com>
parents: 360
diff changeset
4 widgets, Android&apos;s IME structure isn&apos;t designed to directly
360
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
5 support it.</p>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
6 <p>The best way to use Android with a virtual keyboard is in <strong>Portrait</strong>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
7 mode. By default, ConnectBot is set to use <strong>Portrait</strong>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
8 mode when no hardware keyboard is present. To change this setting, go to
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
9 <strong>Preferences</strong> from the <strong>Host List</strong>.</p>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
10 <p>In <strong>Landscape</strong> mode, the Android virtual keyboard
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
11 (or other IMEs) will take up the entire screen. Android provides no way
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
12 for ConnectBot to resize the terminal view in <strong>Landscape</strong>.
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
13 However, you may use a <i>work-around</i>: <strong>Force Resize</strong>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
14 to fit above the virtual keyboard if desired.</p>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
15 <p>On devices without a hardware keyboard, you may press and hold
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
16 the <strong>MENU</strong> button to bring up the virtual keyboard. NOTE:
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
17 This applies to any program on the Android platform; it is not
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
18 ConnectBot specific.</p>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
19
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
20 <h2>How to Enter Control, Alt, Escape, and Function Keys</h2>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
21 <p>You can enter any key combination with ConnectBot and the virtual
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
22 keyboard, but you must know how keys are mapped on a normal console. For
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
23 instance, usually combinations of ALT+letter on a PC keyboard are
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
24 actually mapped to sending, sequentially, ESC key then the letter.</p>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
25 <p>Note there are also screen gestures: see the ScreenGestures help topic.</a>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
26 for <strong>Page Up</strong> and <strong>Page Down</strong>.</p>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
27 <ul>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
28 <li>Trackball: 1 press is <strong>CTRL</strong>, 2 presses sends <strong>ESC</strong>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
29 </li>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
30 <li><strong>Tab key</strong> = <strong>CTRL + i</strong></li>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
31 <li><strong>Function key</strong> = <strong>CTRL + number</strong>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
32 </li>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
33 </ul>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
34
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
35 <h2>On-Screen symbols</h2>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
36 <p>By touching the bottom line of your screen a pop-up list of
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
37 on-screen symbols will appear:</p>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
38 <ul>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
39 <li><strong>Ctrl</strong> - presses the CTRL key. Tap-and-hold
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
40 opens a CTRL+? letter dialog window.</li>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
41 <li><strong>Esc</strong> - presses the ESC key. Tap-and-hold
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
42 opens the Function Keys dialog window.</li>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
43 <li><strong>Sym</strong> - opens the Character Picker window.
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
44 Tap-and-hold opens the arrow keys navigation window.
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
45 <li><strong>Empty</strong> - allows to insert a single line of text.
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
46 <li><strong>Keyboard</strong> - shows the virtual keyboard.
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
47 </ul>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
48
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
49 <h2>Examples</h2>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
50 <ul>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
51 <li><strong>ESC</strong> = Press the trackball twice.</li>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
52 <li><strong>ALT + Right Arrow</strong> = Press trackball twice
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
53 then move trackball to right.</li>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
54 <li><strong>CTRL + A</strong> = Press trackball once then tap the
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
55 &quot;A&quot; key on the soft keyboard.</li>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
56 <li><strong>F3</strong> = Press trackball once then tap the
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
57 &quot;3&quot; key on the soft keyboard.</li>
7eb24880b111 add help files to the web documentation
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
58 </ul>