Function

GtkAccelMaplock_path

since: 2.4

Declaration [src]

void
gtk_accel_map_lock_path (
  const gchar* accel_path
)

Description [src]

Locks the given accelerator path. If the accelerator map doesn’t yet contain an entry for accel_path, a new one is created.

Locking an accelerator path prevents its accelerator from being changed during runtime. A locked accelerator path can be unlocked by gtk_accel_map_unlock_path(). Refer to gtk_accel_map_change_entry() for information about runtime accelerator changes.

If called more than once, accel_path remains locked until gtk_accel_map_unlock_path() has been called an equivalent number of times.

Note that locking of individual accelerator paths is independent from locking the GtkAccelGroup containing them. For runtime accelerator changes to be possible, both the accelerator path and its GtkAccelGroup have to be unlocked.

Available since: 2.4

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.