Method
GtkWidgetset_accel_path
Declaration [src]
void
gtk_widget_set_accel_path (
GtkWidget* widget,
const gchar* accel_path,
GtkAccelGroup* accel_group
)
Description [src]
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_set_accel_path(). 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_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_set_accel_path()
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 g_intern_static_string().
Parameters
accel_path-
Type:
const gchar*Path used to look up the accelerator.
The argument can be NULL.The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string. accel_group-
Type:
GtkAccelGroupA
GtkAccelGroup.The argument can be NULL.The data is owned by the caller of the method.