| 1 | <?xml version="1.0" encoding="UTF-8"?>
|
|---|
| 2 | <!DOCTYPE topic
|
|---|
| 3 | PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
|
|---|
| 4 |
|
|---|
| 5 | <topic xml:lang="en-us" id="soft-keyb">
|
|---|
| 6 | <!-- 7.1: Updated pic added -->
|
|---|
| 7 | <title>Soft Keyboard</title>
|
|---|
| 8 | <body>
|
|---|
| 9 | <p>
|
|---|
| 10 | <ph conkeyref="vbox-conkeyref-phrases/product-name"/> provides a <i>soft keyboard</i> that
|
|---|
| 11 | enables you to input keyboard characters on the guest. A soft
|
|---|
| 12 | keyboard is an on-screen keyboard that can be used as an
|
|---|
| 13 | alternative to a physical keyboard. See
|
|---|
| 14 | <xref href="soft-keyb-using.dita#soft-keyb-using"/> for details of how to use the
|
|---|
| 15 | soft keyboard.
|
|---|
| 16 | </p>
|
|---|
| 17 | <note type="caution">
|
|---|
| 18 | <p>
|
|---|
| 19 | For best results, ensure that the keyboard layout configured on
|
|---|
| 20 | the guest OS matches the keyboard layout used by the soft
|
|---|
| 21 | keyboard. <ph conkeyref="vbox-conkeyref-phrases/product-name"/> does not do this automatically.
|
|---|
| 22 | </p>
|
|---|
| 23 | </note>
|
|---|
| 24 | <fig id="fig-soft-keyb">
|
|---|
| 25 | <title>Soft Keyboard in a Guest Virtual Machine</title>
|
|---|
| 26 | <xref href="images/softkeybd.png" format="png" platform="htmlhelp">
|
|---|
| 27 | <image href="images/softkeybd.png" width="14cm" placement="break">
|
|---|
| 28 | <alt>Soft Keyboard in a Guest Virtual Machine</alt>
|
|---|
| 29 | </image>
|
|---|
| 30 | </xref>
|
|---|
| 31 | <image platform="ohc" href="images/softkeybd.png" width="14cm" placement="break">
|
|---|
| 32 | <alt>Soft Keyboard in a Guest Virtual Machine</alt>
|
|---|
| 33 | </image>
|
|---|
| 34 | </fig>
|
|---|
| 35 | <p>
|
|---|
| 36 | The soft keyboard can be used in the following scenarios:
|
|---|
| 37 | </p>
|
|---|
| 38 | <ul>
|
|---|
| 39 | <li>
|
|---|
| 40 | <p>
|
|---|
| 41 | When the physical keyboard on the host is not the same as the
|
|---|
| 42 | keyboard layout configured on the guest. For example, if the
|
|---|
| 43 | guest is configured to use an international keyboard, but the
|
|---|
| 44 | host keyboard is US English.
|
|---|
| 45 | </p>
|
|---|
| 46 | </li>
|
|---|
| 47 | <li>
|
|---|
| 48 | <p>
|
|---|
| 49 | To send special key combinations to the guest. Note that some
|
|---|
| 50 | common key combinations are also available in the
|
|---|
| 51 | <b outputclass="bold">Input</b>,
|
|---|
| 52 | <b outputclass="bold">Keyboard</b> menu of the guest VM
|
|---|
| 53 | window. See <xref href="specialcharacters.dita#specialcharacters"/>.
|
|---|
| 54 | </p>
|
|---|
| 55 | </li>
|
|---|
| 56 | <li>
|
|---|
| 57 | <p>
|
|---|
| 58 | For guests in kiosk mode, where a physical keyboard is not
|
|---|
| 59 | present.
|
|---|
| 60 | </p>
|
|---|
| 61 | </li>
|
|---|
| 62 | <li>
|
|---|
| 63 | <p>
|
|---|
| 64 | When using nested virtualization, the soft keyboard provides a
|
|---|
| 65 | method of sending key presses to a guest.
|
|---|
| 66 | </p>
|
|---|
| 67 | </li>
|
|---|
| 68 | </ul>
|
|---|
| 69 | <p>
|
|---|
| 70 | By default, the soft keyboard includes some common international
|
|---|
| 71 | keyboard layouts. You can copy and modify these to meet your own
|
|---|
| 72 | requirements. See <xref href="soft-keyb-custom.dita#soft-keyb-custom"/>.
|
|---|
| 73 | </p>
|
|---|
| 74 | </body>
|
|---|
| 75 |
|
|---|
| 76 |
|
|---|
| 77 | </topic>
|
|---|
