Memory-managed wrapper type.

Type class for types which can be safely cast to AccelMap, for instance with toAccelMap.

Cast to AccelMap, for types for which this is known to be safe. For general casts, use castTo.

A convenience alias for Nothing :: Maybe AccelMap.

Registers a new accelerator with the global accelerator map. This function should only be called once per accelPath with the canonical accelKey and accelMods for this path. To change the accelerator during runtime programatically, use accelMapChangeEntry.

Set accelKey and accelMods to 0 to request a removal of the accelerator.

Note that accelPath string will be stored in a GQuark. Therefore, if you pass a static string, you can save some memory by interning it first with internStaticString.

Adds a filter to the global list of accel path filters.

Accel map entries whose accel path matches one of the filters are skipped by accelMapForeach.

This function is intended for GTK+ modules that create their own menus, but don’t want them to be saved into the applications accelerator map dump.

Changes the accelKey and accelMods currently associated with accelPath. 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 accelPath string will be stored in a GQuark. Therefore, if you pass a static string, you can save some memory by interning it first with internStaticString.

Loops over the entries in the accelerator map whose accel path doesn’t match any of the filters added with accelMapAddFilter, and execute foreachFunc on each. The signature of foreachFunc is that of AccelMapForeach, the changed parameter indicates whether this accelerator was changed during runtime (thus, would need saving during an accelerator map dump).

Loops over all entries in the accelerator map, and execute foreachFunc on each. The signature of foreachFunc is that of AccelMapForeach, the changed parameter indicates whether this accelerator was changed during runtime (thus, would need saving during an accelerator map dump).

Gets the singleton global AccelMap object. This object is useful only for notification of changes to the accelerator map via the changed signal; it isn’t a parameter to the other accelerator map functions.

Since: 2.4

Parses a file previously saved with accelMapSave for accelerator specifications, and propagates them accordingly.

Filedescriptor variant of accelMapLoad.

Note that the file descriptor will not be closed by this function.

Scanner variant of accelMapLoad.

Locks the given accelerator path. If the accelerator map doesn’t yet contain an entry for accelPath, 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 accelMapUnlockPath. Refer to accelMapChangeEntry for information about runtime accelerator changes.

If called more than once, accelPath remains locked until accelMapUnlockPath has been called an equivalent number of times.

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

Since: 2.4

Looks up the accelerator entry for accelPath and fills in key.

Saves current accelerator specifications (accelerator path, key and modifiers) to fileName. The file is written in a format suitable to be read back in by accelMapLoad.

Filedescriptor variant of accelMapSave.

Note that the file descriptor will not be closed by this function.

Undoes the last call to accelMapLockPath on this accelPath. Refer to accelMapLockPath for information about accelerator path locking.

Since: 2.4

Notifies of a change in the global accelerator map. The path is also used as the detail for the signal, so it is possible to connect to changed::accel_path.

Since: 2.4

Type for the callback on the (unwrapped) C side.

Connect a signal handler for the changed signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after accelMap #changed callback

This signal admits a optional parameter detail. If it's not Nothing, we will connect to “changed::detail” instead.

Wrap the callback into a GClosure.

Generate a function pointer callable from C code, from a C_AccelMapChangedCallback.

A convenience synonym for Nothing :: Maybe AccelMapChangedCallback.

Connect a signal handler for the changed signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on accelMap #changed callback

This signal admits a optional parameter detail. If it's not Nothing, we will connect to “changed::detail” instead.

Wrap a AccelMapChangedCallback into a C_AccelMapChangedCallback.