Widget.setAccelPath
void setAccelPath(string accelPath = null, gtk.accel_group.AccelGroup accelGroup = null)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].
Parameters
accelPath | path used to look up the accelerator |
accelGroup | a #GtkAccelGroup. |