NAME¶
minput_event_to_key - Convert an event to an input key.
SYNOPSIS¶
MSymbol minput_event_to_key (
MFrame *
frame, void *
event)
DESCRIPTION¶
Convert an event to an input key. The minput_event_to_key() function returns the
input key corresponding to event event on frame by a window system dependent
manner.
In the m17n-X library, event must be a pointer to the structure XKeyEvent
, and it is handled as below.
At first, the keysym name of event is acquired by the function XKeysymToString
. Then, the name is modified as below.
If the name is one of 'a' .. 'z' and event has a Shift modifier, the name is
converted to 'A' .. 'Z' respectively, and the Shift modifier is cleared.
If the name is one byte length and event has a Control modifier, the byte is
bitwise anded by 0x1F and the Control modifier is cleared.
If event still has modifiers, the name is preceded by 'S-' (Shift), 'C-'
(Control), 'M-' (Meta), 'A-' (Alt), 'G-' (AltGr), 's-' (Super), and 'H-'
(Hyper) in this order.
For instance, if the keysym name is 'a' and the event has Shift, Meta, and Hyper
modifiers, the resulting name is 'M-H-A'.
At last, a symbol who has the name is returned.
COPYRIGHT¶
Copyright (C) 2001 Information-technology Promotion Agency (IPA)
Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and
Technology (AIST)
Permission is granted to copy, distribute and/or modify this document under the
terms of the GNU Free Documentation License
<
http://www.gnu.org/licenses/fdl.html>.