comparison assets/help/VirtualKeyboard.html @ 0:0ce5cc452d02

initial version
author Carl Byington <carl@five-ten-sg.com>
date Thu, 22 May 2014 10:41:19 -0700
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:0ce5cc452d02
1 <html>
2 <head><meta http-equiv="content-type" content="text/html; charset=utf-8" /></head>
3 <body bgcolor="#000000" text="#FFFFFF" link="#00FFFF">
4
5 <h2>Virtual Keyboard</h2>
6
7 <p>Since ConnectBot doesn&#x27;t use any of the normal TextView
8 widgets, Android&#x27;s IME structure isn&#x27;t designed to directly
9 support it.</p>
10 <p>The best way to use Android with a virtual keyboard is in <strong>Portrait</strong>
11 mode. By default, ConnectBot is set to use <strong>Portrait</strong>
12 mode when no hardware keyboard is present. To change this setting, go to
13 <strong>Preferences</strong> from the <strong>Host List</strong>.</p>
14 <p>In <strong>Landscape</strong> mode, the Android virtual keyboard
15 (or other IMEs) will take up the entire screen. Android provides no way
16 for ConnectBot to resize the terminal view in <strong>Landscape</strong>.
17 However, you may use a <i>work-around</i>: <strong>Force Resize</strong>
18 to fit above the virtual keyboard if desired.</p>
19 <p>On devices without a hardware keyboard, you may press and hold
20 the <strong>MENU</strong> button to bring up the virtual keyboard. NOTE:
21 This applies to any program on the Android platform; it is not
22 ConnectBot specific.</p>
23
24 <h2>How to Enter Control, Alt, Escape, and Function Keys</h2>
25 <p>You can enter any key combination with ConnectBot and the virtual
26 keyboard, but you must know how keys are mapped on a normal console. For
27 instance, usually combinations of ALT+letter on a PC keyboard are
28 actually mapped to sending, sequentially, ESC key then the letter.</p>
29 <p>Note there are also screen gestures: see the ScreenGestures help topic.</a>
30 for <strong>Page Up</strong> and <strong>Page Down</strong>.</p>
31 <ul>
32 <li>Trackball: 1 press is <strong>CTRL</strong>, 2 presses sends <strong>ESC</strong>
33 </li>
34 <li><strong>Tab key</strong> = <strong>CTRL + i</strong></li>
35 <li><strong>Function key</strong> = <strong>CTRL + number</strong>
36 </li>
37 </ul>
38
39 <h2>On-Screen symbols</h2>
40 <p>By touching the bottom line of your screen a pop-up list of
41 on-screen symbols will appear:</p>
42 <ul>
43 <li><strong>Ctrl</strong> - presses the CTRL key. Tap-and-hold
44 opens a CTRL+? letter dialog window.</li>
45 <li><strong>Esc</strong> - presses the ESC key. Tap-and-hold
46 opens the Function Keys dialog window.</li>
47 <li><strong>Sym</strong> - opens the Character Picker window.
48 Tap-and-hold opens the arrow keys navigation window.
49 <li><strong>Empty</strong> - allows to insert a single line of text.
50 <li><strong>Keyboard</strong> - shows the virtual keyboard.
51 </ul>
52
53 <h2>Examples</h2>
54 <ul>
55 <li><strong>ESC</strong> = Press the trackball twice.</li>
56 <li><strong>ALT + Right Arrow</strong> = Press trackball twice
57 then move trackball to right.</li>
58 <li><strong>CTRL + A</strong> = Press trackball once then tap the
59 &quot;A&quot; key on the soft keyboard.</li>
60 <li><strong>F3</strong> = Press trackball once then tap the
61 &quot;3&quot; key on the soft keyboard.</li>
62 </ul>
63
64 </body>
65 </html>