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