3.1.2.1.1.10 keymapsBad (Key Map Customizations for Mismatched Keyboards)

  • Article

This element serves as a container for individual key map customization entries whose key combinations cannot be described on the current keyboard. See keymaps (§3.1.2.1.1.9, keymaps) for more information about key maps that can be described on the current keyboard.

On write, key maps are placed under keymaps or keymapsBad elements based on the current keyboard, not based on the element they were specified under originally. Key map elements can therefore be moved between these two parent elements depending on the current keyboard. Moreover, either type of key map may be validly defined under either element, but upon resaving each will be moved under the correct element.

The key combinations for key maps placed under the keymapsBad element cannot be executed by Word. Key maps placed under the keymapsBad element are not removed from the file, because they can become operational again when the document is opened on a computer where the specified characters are present on the current keyboard.

Because of their nature, CHM attributes will not be converted to KCM attributes if no such conversion is possible on the current keyboard.

[Example: Consider the following key mapping fragment:

     <wne:keymapsBad>
         <wne:keymap wne:chmPrimary="06DF">
             <wne:fci wne:fciName="Bold" wne:swArg="0000"/>
         </wne:keymap>
     </wne:keymapsBad>

In this example, the fragment specifies a single key map that executes the Bold fixed command when Control-Alt-ß is pressed. Because this character is typically only available on German-language keyboards, the key mapping will be under the keymapsBad element on non-German-language keyboards.   end example]

Parent Elements

tcg (§3.1.2.1.1.12, tcg)

Child Elements

Subclause

keymap (Key Map Entry)

§3.1.2.1.1.8, keymap

The following XML Schema fragment defines the contents of this element:

 <complexType name="CT_Keymaps">
   <sequence>
     <element name="keymap" type="CT_Keymap" minOccurs="1" maxOccurs="unbounded"/>
   </sequence>
 </complexType>