![]() |
![]() |
![]() |
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 : |
TRUE if 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 handler is unregistered. [allow-none]
|
Returns : |
TRUE if 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 FALSE disable 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 |