|  |  |  | libkeybinder-3.0 Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
void (*KeybinderHandler) (const char *keystring,void *user_data); gboolean keybinder_bind (const char *keystring,KeybinderHandler handler,void *user_data); gboolean keybinder_bind_full (const char *keystring,KeybinderHandler handler,void *user_data,GDestroyNotify notify); guint32 keybinder_get_current_event_time (void); void keybinder_init (void); void keybinder_set_use_cooked_accelerators (gboolean use_cooked); void keybinder_unbind (const char *keystring,KeybinderHandler handler); void keybinder_unbind_all (const char *keystring);
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.
| 
 | an accelerator description ( gtk_accelerator_parse()format) | 
| 
 | callback function | 
| 
 | data to pass to handler | 
| Returns : | TRUEif the accelerator could be grabbed | 
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
| 
 | an accelerator description ( gtk_accelerator_parse()format) | 
| 
 | callback function. [scope notified] | 
| 
 | data to pass to handler. [closure][allow-none] | 
| 
 | called when handleris unregistered. [allow-none] | 
| Returns : | TRUEif the accelerator could be grabbed | 
Since 0.3.0
guint32             keybinder_get_current_event_time    (void);
| Returns : | the current event timestamp | 
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.
| 
 | if FALSEdisable cooked accelerators | 
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().
| 
 | an accelerator description ( gtk_accelerator_parse()format) | 
| 
 | callback function |