Method

GtkMenuset_accel_path

Declaration [src]

void
gtk_menu_set_accel_path (
  GtkMenu* menu,
  const gchar* accel_path
)

Description [src]

Sets an accelerator path for this menu from which accelerator paths for its immediate children, its menu items, can be constructed. The main purpose of this function is to spare the programmer the inconvenience of having to call gtk_menu_item_set_accel_path() on each menu item that should support runtime user changable accelerators. Instead, by just calling gtk_menu_set_accel_path() on their parent, each menu item of this menu, that contains a label describing its purpose, automatically gets an accel path assigned.

For example, a menu containing menu items “New” and “Exit”, will, after gtk_menu_set_accel_path (menu, "<Gnumeric-Sheet>/File"); has been called, assign its items the accel paths: "<Gnumeric-Sheet>/File/New" and "<Gnumeric-Sheet>/File/Exit".

Assigning accel paths to menu items then enables the user to change their accelerators at runtime. More details about accelerator paths and their default setups can be found at gtk_accel_map_add_entry().

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().

Sets propertyGtk.Menu:accel-path

Parameters

accel_path

Type: const gchar*

A valid accelerator path, or NULL to unset the path.

The argument can be NULL.
The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.