Function

GtkAccelMapchange_entry

Declaration [src]

gboolean
gtk_accel_map_change_entry (
  const gchar* accel_path,
  guint accel_key,
  GdkModifierType accel_mods,
  gboolean replace
)

Description [src]

Changes the accel_key and accel_mods currently associated with accel_path. Due to conflicts with other accelerators, a change may not always be possible, replace indicates whether other accelerators may be deleted to resolve such conflicts. A change will only occur if all conflicts could be resolved (which might not be the case if conflicting accelerators are locked). Successful changes are indicated by a TRUE return value.

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*

A valid accelerator path.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
accel_key

Type: guint

The new accelerator key.

accel_mods

Type: GdkModifierType

The new accelerator modifiers.

replace

Type: gboolean

TRUE if other accelerators may be deleted upon conflicts.

Return value

Type: gboolean

TRUE if the accelerator could be changed, FALSE otherwise.