Usually you won't need to create a Gtk::AccelGroup directly; instead, gtkmm automatically sets up the accelerators for your menus. Note that accelerators are different from mnemonics. Accelerators are shortcuts for activating a menu item; they appear alongside the menu item for which they're a shortcut. For example "Ctrl+Q" might appear alongside the "Quit" menu item. Mnemonics are shortcuts for GUI elements such as text entries or buttons; they appear as underlined characters. See the Gtk::Label constructor. Menu items can have both accelerators and mnemonics, of course.
|
Public Member Functions |
bool | activate (GQuark accel_quark, const Glib::RefPtr<Glib::Object>& acceleratable, guint accel_key, Gdk::ModifierType accel_mods) |
bool | disconnect_key (guint accel_key, Gdk::ModifierType accel_mods) |
| Removes an accelerator previously installed through connect().
|
const GtkAccelGroup* | gobj () const |
| Provides access to the underlying C GObject.
|
GtkAccelGroup* | gobj () |
| Provides access to the underlying C GObject.
|
GtkAccelGroup* | gobj_copy () |
| Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
|
void | lock () |
| Locks the given accelerator group.
|
Glib::SignalProxy3< bool,
const Glib::RefPtr< Glib::Object > &,
guint, Gdk::ModifierType > | signal_accel_activate () |
Glib::SignalProxy3< void,
guint, Gdk::ModifierType,
GClosure* > | signal_accel_changed () |
void | unlock () |
| Undoes the last call to lock() on this accel_group .
|
virtual | ~AccelGroup () |
Static Public Member Functions |
static bool | activate (Gtk::Object& object, guint accel_key, Gdk::ModifierType accel_mods) |
| Finds the first accelerator in any Gtk::AccelGroup attached to object that matches accel_key and accel_mods , and activates that accelerator.
|
static Glib::RefPtr<AccelGroup> | create () |
| Creates a new Gtk::AccelGroup object.
|
static Gdk::ModifierType | get_default_mod_mask () |
| See set_default_mod_mask().
|
static Glib::ustring | get_label (guint accelerator_key, Gdk::ModifierType accelerator_mods) |
| Converts an accelerator keyval and modifier mask into a string which can be used to represent the accelerator to the user.
|
static Glib::ustring | name (guint accelerator_key, Gdk::ModifierType accelerator_mods) |
| Converts an accelerator keyval and modifier mask into a string parseable by parse().
|
static void | parse (const Glib::ustring& accelerator, guint& accelerator_key, Gdk::ModifierType& accelerator_mods) |
| Parse the accelerator string.
|
static void | set_default_mod_mask (Gdk::ModifierType default_mod_mask) |
| Sets the modifiers that will be considered significant for keyboard accelerators.
|
static bool | valid (guint keyval, Gdk::ModifierType modifiers) |
| Determines whether a given keyval and modifier mask constitute a valid keyboard accelerator.
|
Protected Member Functions |
| AccelGroup () |
virtual void | on_accel_changed (guint keyval, Gdk::ModifierType modifier, GClosure* accel_closure) |
Related Functions |
(Note that these are not member functions.)
|
Glib::RefPtr<Gtk::AccelGroup> | wrap (GtkAccelGroup* object, bool take_copy=false) |