~kamstrup/gtkhotkey/trunk

« back to all changes in this revision

Viewing changes to src/gtk-hotkey-registry.c

  • Committer: "Mikkel Kamstrup Erlandsen"
  • Date: 2009-10-01 08:59:31 UTC
  • Revision ID: mikkel.kamstrup@gmail.com-20091001085931-dma9e0loluq3snum
More work towards getting the 0.3 API ready. Among which implement gtk_hotkey_set_signature() with rebinding if necessary (also add this functionality for when setting the signature via the properties)

Show diffs side-by-side

added added

removed removed

Lines of Context:
43
43
 
44
44
/**
45
45
 * SECTION:gtk-hotkey-registry
46
 
 * @short_description: Abstract base class for services storing and loading hotkeys
 
46
 * @short_description: Base class for services storing and loading hotkeys
47
47
 * @see_also: #GtkHotkeyKeyFileRegistry
48
 
 *
49
 
 * #GtkHotkeyRegistry is an abstract base class for implementing a platform
50
 
 * specific service for storing and loading hotkey configurations.
51
 
 *
52
 
 * The actual binding of the hotkey into the environment is done by a
53
 
 * #GtkHotkeyListener. This class is only meant to do the management part of the
54
 
 * hotkey handling.
55
 
 *
56
 
 * The reasong why applications should use a #GtkHotkeyRegistry and not just a
57
 
 * flat text file with the hotkey signature is to make sure we don't overwrite
58
 
 * or interfere with the hotkeys of other applications. And possibly providing
59
 
 * a unified user interface for managing the hotkeys of all applications.
60
 
 *
61
 
 * To obtain a #GtkHotkeyRegistry matching your desktop environment use
62
 
 * the factory method gtk_hotkey_registry_get_default().
63
 
 *
64
 
 **/    
 
48
 * @include: gtkhotkey.h
 
49
 *
 
50
 * #GtkHotkeyRegistry implements a platform specific service for storing and
 
51
 * loading hotkey configurations. To obtain a #GtkHotkeyRegistry matching
 
52
 * your platform use the factory method gtk_hotkey_registry_get_default().
 
53
 *
 
54
 * The #GtkHotkeyRegistry also acts as a factory for #GtkHotkey instances.
 
55
 * This ensures that we can have cross application hotkey validation so that
 
56
 * applications don't steal hotkeys from each others inadvertently.
 
57
 *
 
58
 * The actual binding of the hotkey into the environment is done transparently
 
59
 * by a #GtkHotkeyListener instance and is not related to the registry. The
 
60
 * registry is only meant to do the life cycle management of the hotkeys.
 
61
 *
 
62
 */
65
63
 
66
64
/**
67
65
 * gtk_hotkey_registry_get_default