diff options
Diffstat (limited to 'libs/gtkmm2/gtk/gtkmm/accelgroup.h')
-rw-r--r-- | libs/gtkmm2/gtk/gtkmm/accelgroup.h | 249 |
1 files changed, 249 insertions, 0 deletions
diff --git a/libs/gtkmm2/gtk/gtkmm/accelgroup.h b/libs/gtkmm2/gtk/gtkmm/accelgroup.h new file mode 100644 index 0000000000..1a6a8adc4d --- /dev/null +++ b/libs/gtkmm2/gtk/gtkmm/accelgroup.h @@ -0,0 +1,249 @@ +// -*- c++ -*- +// Generated by gtkmmproc -- DO NOT MODIFY! +#ifndef _GTKMM_ACCELGROUP_H +#define _GTKMM_ACCELGROUP_H + +#include <glibmm.h> + +/* $Id$ */ + +/* Copyright (C) 1998-2002 The gtkmm Development Team + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Library General Public + * License as published by the Free Software Foundation; either + * version 2 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Library General Public License for more details. + * + * You should have received a copy of the GNU Library General Public + * License along with this library; if not, write to the Free + * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + */ + + +#include <gdkmm/types.h> +#include <gtkmm/object.h> + + +#ifndef DOXYGEN_SHOULD_SKIP_THIS +typedef struct _GtkAccelGroup GtkAccelGroup; +typedef struct _GtkAccelGroupClass GtkAccelGroupClass; +#endif /* DOXYGEN_SHOULD_SKIP_THIS */ + + +namespace Gtk +{ class AccelGroup_Class; } // namespace Gtk +namespace Gtk +{ + +/** A Gtk::AccelGroup represents a group of keyboard accelerators, typically + * attached to a toplevel Gtk::Window (with Gtk::Window::add_accel_group()). + * 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. + * + * You can use Gtk::Window::get_accel_group() to get an accel group for that window, + * then use it with other widgets too. + */ + +class AccelGroup : public Glib::Object +{ + +#ifndef DOXYGEN_SHOULD_SKIP_THIS + +public: + typedef AccelGroup CppObjectType; + typedef AccelGroup_Class CppClassType; + typedef GtkAccelGroup BaseObjectType; + typedef GtkAccelGroupClass BaseClassType; + +private: friend class AccelGroup_Class; + static CppClassType accelgroup_class_; + +private: + // noncopyable + AccelGroup(const AccelGroup&); + AccelGroup& operator=(const AccelGroup&); + +protected: + explicit AccelGroup(const Glib::ConstructParams& construct_params); + explicit AccelGroup(GtkAccelGroup* castitem); + +#endif /* DOXYGEN_SHOULD_SKIP_THIS */ + +public: + virtual ~AccelGroup(); + +#ifndef DOXYGEN_SHOULD_SKIP_THIS + static GType get_type() G_GNUC_CONST; + static GType get_base_type() G_GNUC_CONST; +#endif + + ///Provides access to the underlying C GObject. + GtkAccelGroup* gobj() { return reinterpret_cast<GtkAccelGroup*>(gobject_); } + + ///Provides access to the underlying C GObject. + const GtkAccelGroup* gobj() const { return reinterpret_cast<GtkAccelGroup*>(gobject_); } + + ///Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. + GtkAccelGroup* gobj_copy(); + +private: + + +protected: + AccelGroup(); + +public: + /** Creates a new Gtk::AccelGroup object. + * @return A Glib::RefPtr<> to a newly created Gtk::AccelGroup object. + */ + + static Glib::RefPtr<AccelGroup> create(); + + + /** Locks the given accelerator group. + * + * Locking an acelerator group prevents the accelerators contained + * within it to be changed during runtime. Refer to + * gtk_accel_map_change_entry() about runtime accelerator changes. + * + * If called more than once, @a accel_group remains locked until + * unlock() has been called an equivalent number + * of times. + */ + void lock(); + + /** Undoes the last call to lock() on this @a accel_group . + */ + void unlock(); + + /** Removes an accelerator previously installed through + * connect(). + * @param accel_key Key value of the accelerator. + * @param accel_mods Modifier combination of the accelerator. + * @return <tt>true</tt> if there was an accelerator which could be + * removed, <tt>false</tt> otherwise. + */ + bool disconnect_key(guint accel_key, Gdk::ModifierType accel_mods); + + /** Determines whether a given keyval and modifier mask constitute + * a valid keyboard accelerator. For example, the 'a' keyval + * plus Gdk::CONTROL_MASK is valid - this is a "Ctrl+a" accelerator. + * But you can't, for instance, use the GDK_Control_L keyval + * as an accelerator. + */ + static bool valid(guint keyval, Gdk::ModifierType modifiers); + + /** Parse the accelerator string. + * @param accelerator See the Gtk::AccelKey constructor for the format. + * @param accelerator_key Output argument + * @param accelerator_mods Output argument + */ + static void parse(const Glib::ustring& accelerator, guint& accelerator_key, Gdk::ModifierType& accelerator_mods); + + /** Converts an accelerator keyval and modifier mask + * into a string parseable by parse(). + * For example, if you pass in 'q' and Gdk::CONTROL_MASK, it returns "<Control>q". + */ + static Glib::ustring name(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. + * @param accelerator_key Accelerator keyval. + * @param accelerator_mods Accelerator modifier mask. + * @return A newly-allocated string representing the accelerator. + * + * Since: 2.6. + */ + static Glib::ustring get_label(guint accelerator_key, Gdk::ModifierType accelerator_mods); + + /** Sets the modifiers that will be considered significant for keyboard + * accelerators. The default mod mask is Gdk::CONTROL_MASK | + * Gdk::SHIFT_MASK | Gdk::MOD1_MASK, that is, Control, Shift, and Alt. + * Other modifiers will ignored by default. + * You must include at least the three default modifiers in any + * value you pass to this function. + * + * The default mod mask should be changed on application startup, + * before using any accelerator groups. + */ + static void set_default_mod_mask(Gdk::ModifierType default_mod_mask); + + /// See set_default_mod_mask(). + static Gdk::ModifierType get_default_mod_mask(); + + //TODO: This is undocumented in GTK+ at the moment. When would it be used and where does the quark come from? murrayc. + + bool activate(GQuark accel_quark, const Glib::RefPtr<Glib::Object>& acceleratable, guint accel_key, Gdk::ModifierType accel_mods); + + + //Let's not wrap this, because the GtkAccelGroupFindFunc callback uses GClosures, and it's not clear that this is useful. + //AccelKey find(const SlotFind& slot); + //GtkAccelKey* gtk_accel_group_find(GtkAccelGroup* accel_group, GtkAccelGroupFindFunc find_func, gpointer data); + + + /** Finds the first accelerator in any Gtk::AccelGroup attached + * to @a object that matches @a accel_key and @a accel_mods , and + * activates that accelerator. + * If an accelerator was activated and handled this keypress, <tt>true</tt> + * is returned. + * @param object The G::Object, usually a Gtk::Window, on which + * to activate the accelerator. + * @param accel_key Accelerator keyval from a key event. + * @param accel_mods Keyboard state mask from a key event. + * @return <tt>true</tt> if the accelerator was handled, <tt>false</tt> otherwise. + */ + static bool activate(Gtk::Object& object, guint accel_key, Gdk::ModifierType accel_mods); + + //TODO: Discover real parameter names: + + + Glib::SignalProxy3< bool,const Glib::RefPtr<Glib::Object>&,guint,Gdk::ModifierType > signal_accel_activate(); + + //TODO: The C type is unpleasant: + + + Glib::SignalProxy3< void,guint,Gdk::ModifierType,GClosure* > signal_accel_changed(); + + +public: + +public: + //C++ methods used to invoke GTK+ virtual functions: + +protected: + //GTK+ Virtual Functions (override these to change behaviour): + + //Default Signal Handlers:: + virtual void on_accel_changed(guint keyval, Gdk::ModifierType modifier, GClosure* accel_closure); + + +}; + +} // namespace Gtk + + +namespace Glib +{ + /** @relates Gtk::AccelGroup + * @param object The C instance + * @param take_copy False if the result should take ownership of the C instance. True if it should take a new copy or ref. + * @result A C++ instance that wraps this C instance. + */ + Glib::RefPtr<Gtk::AccelGroup> wrap(GtkAccelGroup* object, bool take_copy = false); +} + + +#endif /* _GTKMM_ACCELGROUP_H */ + |