Method
GdkKeymapget_entries_for_keyval
Declaration [src]
gboolean
gdk_keymap_get_entries_for_keyval (
GdkKeymap* keymap,
guint keyval,
GdkKeymapKey** keys,
gint* n_keys
)
Description [src]
Obtains a list of keycode/group/level combinations that will
generate keyval
. Groups and levels are two kinds of keyboard mode;
in general, the level determines whether the top or bottom symbol
on a key is used, and the group determines whether the left or
right symbol is used. On US keyboards, the shift key changes the
keyboard level, and there are no groups. A group switch key might
convert a keyboard between Hebrew to English modes, for example.
GdkEventKey
contains a %group field that indicates the active
keyboard group. The level is computed from the modifier mask.
The returned array should be freed
with g_free().
Parameters
keyval
-
Type:
guint
A keyval, such as %GDK_KEY_a, %GDK_KEY_Up, %GDK_KEY_Return, etc.
keys
-
Type: An array of
GdkKeymapKey*
Return location for an array of
GdkKeymapKey
.The argument will be set by the function. The length of the array is specified in the n_keys
argument.The caller of the method takes ownership of the returned data, and is responsible for freeing it. n_keys
-
Type:
gint*
Return location for number of elements in returned array.
The argument will be set by the function.