49 lines
2.9 KiB
XML
49 lines
2.9 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE topic
|
|
PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
|
|
<topic xml:lang="en-us" id="soft-keyb-custom">
|
|
<title>Creating a Custom Keyboard Layout</title>
|
|
|
|
<body>
|
|
<p>You can use one of the supplied default keyboard layouts as the starting point to create a custom
|
|
keyboard layout. </p>
|
|
<note>
|
|
<p>To permanently save a custom keyboard layout, you must save it to a file. Otherwise, any changes
|
|
you make are discarded when you close down the <b outputclass="bold">Soft Keyboard</b> window. </p>
|
|
<p>Custom keyboard layouts that you save are stored as an XML file on the host, in the
|
|
<filepath>keyboardLayouts</filepath> folder in the global configuration data directory. For example, in
|
|
<filepath>$HOME/.config/VirtualBox/keyboardLayouts</filepath> on a Linux host. </p>
|
|
</note>
|
|
<ol>
|
|
<li>
|
|
<p>Display the <b outputclass="bold">Layout List</b>. </p>
|
|
<p>Click the <b outputclass="bold">Layout List</b> icon in the toolbar of the soft keyboard
|
|
window. </p>
|
|
</li>
|
|
<li>
|
|
<p>Make a copy of an existing keyboard layout. </p>
|
|
<p>Highlight the required layout and click the <b outputclass="bold">Copy the Selected
|
|
Layout</b> icon. </p>
|
|
<p>A new layout entry with a name suffix of <codeph>-Copy</codeph> is created. </p>
|
|
</li>
|
|
<li>
|
|
<p>Edit the new keyboard layout. </p>
|
|
<p>Highlight the new layout in the <b outputclass="bold">Layout List</b> and click the <b
|
|
outputclass="bold">Edit the Selected Layout</b> icon. </p>
|
|
<p>Enter a new name for the layout. </p>
|
|
<p>Edit keys in the new layout. Click the key that you want to edit and enter new key captions
|
|
in the <b outputclass="bold">Captions</b> fields. </p>
|
|
<p>The keyboard graphic is updated with the new captions. </p>
|
|
</li>
|
|
<li>
|
|
<p>(Optional) Save the layout to a file. This means that your custom keyboard layout will be
|
|
available for future use. </p>
|
|
<p>Highlight the new layout in the <b outputclass="bold">Layout List</b> and click the <b
|
|
outputclass="bold">Save the Selected Layout into File</b> icon. </p>
|
|
<p>Any custom layouts that you create can later be removed from the Layout List, by highlighting
|
|
and clicking the <b outputclass="bold">Delete the Selected Layout</b> icon. </p>
|
|
</li>
|
|
</ol>
|
|
</body>
|
|
|
|
</topic>
|