| 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-custom">
|
|---|
| 5 | <title>Creating a Custom Keyboard Layout</title>
|
|---|
| 6 |
|
|---|
| 7 | <body>
|
|---|
| 8 | <p>You can use one of the supplied default keyboard layouts as the starting point to create a custom
|
|---|
| 9 | keyboard layout. </p>
|
|---|
| 10 | <note>
|
|---|
| 11 | <p>To permanently save a custom keyboard layout, you must save it to a file. Otherwise, any changes
|
|---|
| 12 | you make are discarded when you close down the <b outputclass="bold">Soft Keyboard</b> window. </p>
|
|---|
| 13 | <p>Custom keyboard layouts that you save are stored as an XML file on the host, in the
|
|---|
| 14 | <filepath>keyboardLayouts</filepath> folder in the global configuration data directory. For example, in
|
|---|
| 15 | <filepath>$HOME/.config/VirtualBox/keyboardLayouts</filepath> on a Linux host. </p>
|
|---|
| 16 | </note>
|
|---|
| 17 | <ol>
|
|---|
| 18 | <li>
|
|---|
| 19 | <p>Display the <b outputclass="bold">Layout List</b>. </p>
|
|---|
| 20 | <p>Click the <b outputclass="bold">Layout List</b> icon in the toolbar of the soft keyboard
|
|---|
| 21 | window. </p>
|
|---|
| 22 | </li>
|
|---|
| 23 | <li>
|
|---|
| 24 | <p>Make a copy of an existing keyboard layout. </p>
|
|---|
| 25 | <p>Highlight the required layout and click the <b outputclass="bold">Copy the Selected
|
|---|
| 26 | Layout</b> icon. </p>
|
|---|
| 27 | <p>A new layout entry with a name suffix of <codeph>-Copy</codeph> is created. </p>
|
|---|
| 28 | </li>
|
|---|
| 29 | <li>
|
|---|
| 30 | <p>Edit the new keyboard layout. </p>
|
|---|
| 31 | <p>Highlight the new layout in the <b outputclass="bold">Layout List</b> and click the <b
|
|---|
| 32 | outputclass="bold">Edit the Selected Layout</b> icon. </p>
|
|---|
| 33 | <p>Enter a new name for the layout. </p>
|
|---|
| 34 | <p>Edit keys in the new layout. Click the key that you want to edit and enter new key captions
|
|---|
| 35 | in the <b outputclass="bold">Captions</b> fields. </p>
|
|---|
| 36 | <p>The keyboard graphic is updated with the new captions. </p>
|
|---|
| 37 | </li>
|
|---|
| 38 | <li>
|
|---|
| 39 | <p>(Optional) Save the layout to a file. This means that your custom keyboard layout will be
|
|---|
| 40 | available for future use. </p>
|
|---|
| 41 | <p>Highlight the new layout in the <b outputclass="bold">Layout List</b> and click the <b
|
|---|
| 42 | outputclass="bold">Save the Selected Layout into File</b> icon. </p>
|
|---|
| 43 | <p>Any custom layouts that you create can later be removed from the Layout List, by highlighting
|
|---|
| 44 | and clicking the <b outputclass="bold">Delete the Selected Layout</b> icon. </p>
|
|---|
| 45 | </li>
|
|---|
| 46 | </ol>
|
|---|
| 47 | </body>
|
|---|
| 48 |
|
|---|
| 49 | </topic>
|
|---|
