Top | ![]() |
![]() |
![]() |
![]() |
void | (*KeybinderHandler) () |
void | keybinder_init () |
void | keybinder_set_use_cooked_accelerators () |
gboolean | keybinder_bind () |
gboolean | keybinder_bind_full () |
void | keybinder_unbind () |
void | keybinder_unbind_all () |
guint32 | keybinder_get_current_event_time () |
gboolean | keybinder_supported () |
void
keybinder_init (void
);
Initialize the keybinder library.
This function must be called after initializing GTK, before calling any other function in the library. Can only be called once.
void
keybinder_set_use_cooked_accelerators (gboolean use_cooked
);
"Cooked" accelerators use symbols produced by using modifiers such as shift or altgr, for example if "!" is produced by "Shift+1".
If cooked accelerators are enabled, use "<Ctrl>exclam" to bind "Ctrl+!" If disabled, use "<Ctrl><Shift>1" to bind "Ctrl+Shift+1". These two examples are not equal on all keymaps.
The cooked accelerator keyvalue and modifiers are provided by the
function gdk_keymap_translate_keyboard_state()
Cooked accelerators are useful if you receive keystrokes from GTK to bind, but raw accelerators can be useful if you or the user inputs accelerators as text.
Default: Enabled. Should be set before binding anything.
gboolean keybinder_bind (const char *keystring
,KeybinderHandler handler
,void *user_data
);
Grab a key combination globally and register a callback to be called each time the key combination is pressed.
This function is excluded from introspected bindings and is replaced by keybinder_bind_full.
[skip]
keystring |
an accelerator description ( |
|
handler |
callback function |
|
user_data |
data to pass to |
gboolean keybinder_bind_full (const char *keystring
,KeybinderHandler handler
,void *user_data
,GDestroyNotify notify
);
Grab a key combination globally and register a callback to be called each time the key combination is pressed.
[rename-to keybinder_bind]
keystring |
an accelerator description ( |
|
handler |
callback function. |
[scope notified] |
user_data |
data to pass to |
[closure][allow-none] |
notify |
called when |
[allow-none] |
Since: 0.3.0
void keybinder_unbind (const char *keystring
,KeybinderHandler handler
);
Unregister a previously bound callback for this keystring.
NOTE: multiple callbacks per keystring are not properly supported. You
might as well use keybinder_unbind_all()
.
This function is excluded from introspected bindings and is replaced by
keybinder_unbind_all()
.
[skip]
keystring |
an accelerator description ( |
|
handler |
callback function |
void
keybinder_unbind_all (const char *keystring
);
Unregister all previously bound callbacks for this keystring.
[rename-to keybinder_unbind]
Since: 0.3.0