Given an accelerator group, accel_group, and an accelerator path,
accel_path, sets up an accelerator in accel_group so whenever the
key binding that is defined for accel_path is pressed, widget
will be activated. This removes any accelerators (for any
accelerator group) installed by previous calls to
gtk.widget.Widget.setAccelPath. Associating accelerators with
paths allows them to be modified by the user and the modifications
to be saved for future use. (See gtk.accel_map.AccelMap.save.)
This function is a low level function that would most likely
be used by a menu creation system like #GtkUIManager. If you
use #GtkUIManager, setting up accelerator paths will be done
automatically.
Even when you you aren’t using #GtkUIManager, if you only want to
set up accelerators on menu items gtk.menu_item.MenuItem.setAccelPath
provides a somewhat more convenient interface.
Note that accel_path string will be stored in a #GQuark. Therefore, if you
pass a static string, you can save some memory by interning it first with
glib.global.internStaticString.
Given an accelerator group, accel_group, and an accelerator path, accel_path, sets up an accelerator in accel_group so whenever the key binding that is defined for accel_path is pressed, widget will be activated. This removes any accelerators (for any accelerator group) installed by previous calls to gtk.widget.Widget.setAccelPath. Associating accelerators with paths allows them to be modified by the user and the modifications to be saved for future use. (See gtk.accel_map.AccelMap.save.)
This function is a low level function that would most likely be used by a menu creation system like #GtkUIManager. If you use #GtkUIManager, setting up accelerator paths will be done automatically.
Even when you you aren’t using #GtkUIManager, if you only want to set up accelerators on menu items gtk.menu_item.MenuItem.setAccelPath provides a somewhat more convenient interface.
Note that accel_path string will be stored in a #GQuark. Therefore, if you pass a static string, you can save some memory by interning it first with glib.global.internStaticString.