XChangeKeyboardMapping(3X) — X Version 11

NAME

XChangeKeyboardMapping, XGetKeyboardMapping, XSetModifierMapping, XGetModifierMapping, XNewModifierMap, XInsertModifiermapEntry, XDeleteModifiermapEntry, XFreeModifierMap − manipulate keyboard encoding

SYNTAX

XChangeKeyboardMapping(display, first_keycode, keysyms_per_keycode, keysyms, num_codes)
      Display ∗display;
      int first_keycode;
      int keysyms_per_keycode;
      KeySym ∗keysyms;
      int num_codes;

KeySym ∗XGetKeyboardMapping(display, first_keycode_wanted, keycode_count,
                            keysyms_per_keycode_return)
      Display ∗display;
      KeyCode first_keycode_wanted;
      int keycode_count;
      int ∗keysyms_per_keycode_return;

int XSetModifierMapping(display, modmap)
Display ∗display;
XModifierKeymap ∗modmap;

XModifierKeymap ∗XGetModifierMapping(display)
Display ∗display;

XModifierKeymap ∗XNewModifierMap(max_keys_per_mod)
int max_keys_per_mod;

XModifierKeymap ∗XInsertModifiermapEntry(modmap, keysym_entry, modifier)
     XModifierKeymap ∗modmap;
     KeyCode keysym_entry;
     int modifier;

XModifierKeymap ∗XDeleteModifiermapEntry(modmap, keysym_entry, modifier)
     XModifierKeymap ∗modmap;
     KeyCode keysym_entry;
     int modifier;

XFreeModifierMap(modmap)
XModifierKeymap ∗modmap;

ARGUMENTS

keycode_count
Specifies the number of keycodes that are to be returned.

displaySpecifies the connection to the X server.

first_keycodeSpecifies the first keycode that is to be changed.

first_keycode_wanted
Specifies the first keycode that is to be returned.

keysymsSpecifies a pointer to an array of keysyms.

keysym_entry
Specifies the keysyms.

keysyms_per_keycode
Specifies the keysyms that are to be used.

keysyms_per_keycode_return
Returns the number of keysyms per keycode.

max_keys_per_mod
Specifies the maximum number of keycodes assigned to any of the modifiers in the map.

modifierSpecifies the modifier.

modmapSpecifies a pointer to the XModifierKeymap structure.

num_codesSpecifies the number of keycodes that are to be changed.

DESCRIPTION

The XChangeKeyboardMapping function, starting with first_keycode, defines the symbols for the specified number of keycodes. .PN XChangeKeyboardMapping can generate BadAlloc, BadLength, and BadValue errors.

The XGetKeyboardMapping function, starting with first_keycode, returns the symbols for the specified number of keycodes. .PN XGetKeyboardMapping can generate a BadValue error.

The XSetModifierMapping function specifies the keycodes of the keys, if any, that are to be used as modifiers. .PN XSetModifierMapping can generate BadAlloc and BadValue errors.

The XGetModifierMapping function returns a newly created XModifierKeymap structure that contains the keys being used as modifiers.

The XNewModifierMapping function returns a XModifierKeymap structure.

The XInsertModifiermapEntry function add the specified keycode to the set that controls the specified modifier and returns the resulting XModifierKeymap structure (expanded as needed).

The XDeleteModifiermapEntry function deletes the specified keycode from the set that controls the specified modifier and returns the resulting XModifierKeymap structure.

The XFreeModifierMapping function frees the specified XModifierKeymap structure.

DIAGNOSTICS

BadAlloc The server failed to allocate the requested resource or server memory.

BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined by the argument’s type is accepted. Any argument defined as a set of alternatives can generate this error.

Museum