add ActionManager::set_sensitive() for Gtk::ActionGroup
[ardour.git] / libs / gtkmm2ext / gtkmm2ext / actions.h
index d92f85bb6eeeba8b58bfde385d8e7d9a1cd6a271..6311a98631396e36acefe3557104a4efd4cdb67e 100644 (file)
@@ -36,61 +36,71 @@ namespace Gtk {
 
 namespace ActionManager {
 
+/* Why is this a namespace and not a class?
+ *
+ * 1) We want it to behave like a singleton without an instance() method. This
+ * would normally be accomplished by using a set of static methods and member
+ * variables.
+ *
+ * 2) We need to extend the contents of the (class|namespace) in
+ * gtk2_ardour. We can't do this with a class without inheritance, which is not
+ * what we're looking for because we want a non-instance singleton.
+ *
+ * Hence, we use namespacing to allow us to write ActionManager::foobar() as
+ * well as the extensions in gtk2_ardour/actions.h
+ *
+ */
+
+       LIBGTKMM2EXT_API extern void init ();
+
        LIBGTKMM2EXT_API extern std::string unbound_string;  /* the key string returned if an action is not bound */
        LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::UIManager> ui_manager;
-       
+
+       LIBGTKMM2EXT_API extern void set_sensitive (Glib::RefPtr<Gtk::ActionGroup> group, bool yn);
        LIBGTKMM2EXT_API extern void set_sensitive (std::vector<Glib::RefPtr<Gtk::Action> >& actions, bool);
        LIBGTKMM2EXT_API extern std::string get_key_representation (const std::string& accel_path, Gtk::AccelKey& key);
-
        LIBGTKMM2EXT_API extern Gtk::Widget* get_widget (const char * name);
-       LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::Action> get_action (const char* group, const char* name);
-       LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::Action> get_action (const char* path);
-       LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::Action> get_action_from_name (const char* name);
        LIBGTKMM2EXT_API extern void do_action (const char* group, const char* name);
        LIBGTKMM2EXT_API extern void set_toggle_action (const char* group, const char* name, bool);
+       LIBGTKMM2EXT_API extern void check_toggleaction (const std::string&);
+       LIBGTKMM2EXT_API extern void uncheck_toggleaction (const std::string&);
+       LIBGTKMM2EXT_API extern void set_toggleaction_state (const std::string&, bool);
+       LIBGTKMM2EXT_API extern bool set_toggleaction_state (const char*, const char*, bool);
+       LIBGTKMM2EXT_API extern void save_action_states ();
+       LIBGTKMM2EXT_API extern void enable_active_actions ();
+       LIBGTKMM2EXT_API extern void disable_active_actions ();
 
-       LIBGTKMM2EXT_API extern void add_action_group (Glib::RefPtr<Gtk::ActionGroup>);
+       LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::ActionGroup> create_action_group (std::string const & group_name);
 
+       LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::Action> register_action (Glib::RefPtr<Gtk::ActionGroup> group, const char* name, const char* label);
        LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::Action> register_action (Glib::RefPtr<Gtk::ActionGroup> group,
-                                                  const char * name, const char * label);
-       LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::Action> register_action (Glib::RefPtr<Gtk::ActionGroup> group,
-                                                  const char * name, const char * label, sigc::slot<void> sl,
-                                                  guint key, Gdk::ModifierType mods);
-       LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::Action> register_action (Glib::RefPtr<Gtk::ActionGroup> group,
-                                                  const char * name, const char * label, sigc::slot<void> sl);
-
-       LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::Action> register_radio_action (Glib::RefPtr<Gtk::ActionGroup> group, Gtk::RadioAction::Group&,
-                                                               const char * name, const char * label, sigc::slot<void> sl,
-                                                               guint key, Gdk::ModifierType mods);
-       LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::Action> register_radio_action (Glib::RefPtr<Gtk::ActionGroup> group, Gtk::RadioAction::Group&,
-                                                               const char * name, const char * label, sigc::slot<void> sl);
-       LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::Action> register_radio_action (Glib::RefPtr<Gtk::ActionGroup> group, Gtk::RadioAction::Group&,
-                                                               std::string const &, std::string const &, std::string const &, sigc::slot<void> sl);
-
-       LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::Action> register_toggle_action (Glib::RefPtr<Gtk::ActionGroup> group,
-                                                         const char * name, const char * label, sigc::slot<void> sl,
-                                                         guint key, Gdk::ModifierType mods);
-       LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::Action> register_toggle_action (Glib::RefPtr<Gtk::ActionGroup> group,
-                                                                std::string const &, std::string const &, std::string const &, sigc::slot<void> sl);
+                                                                          const char* name, const char* label, sigc::slot<void> sl);
+       LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::Action> register_radio_action (Glib::RefPtr<Gtk::ActionGroup> group,
+                                                        Gtk::RadioAction::Group&,
+                                                        const char* name, const char* label,
+                                                        sigc::slot<void,GtkAction*> sl,
+                                                        int value);
+       LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::Action> register_radio_action (Glib::RefPtr<Gtk::ActionGroup> group,
+                                                        Gtk::RadioAction::Group&,
+                                                        const char* name, const char* label,
+                                                        sigc::slot<void> sl);
        LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::Action> register_toggle_action (Glib::RefPtr<Gtk::ActionGroup> group,
-                                                                const char * name, const char * label, sigc::slot<void> sl);
+                                                         const char* name, const char* label, sigc::slot<void> sl);
 
-       LIBGTKMM2EXT_API extern bool lookup_entry (const Glib::ustring accel_path, Gtk::AccelKey& key);
+       LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::Action>       get_action (const std::string& name, bool or_die = true);
+       LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::Action>       get_action (char const * group_name, char const * action_name, bool or_die = true);
+       LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::ToggleAction> get_toggle_action (const std::string& name, bool or_die = true);
+       LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::ToggleAction> get_toggle_action (char const * group_name, char const * action_name, bool or_die = true);
+       LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::RadioAction>  get_radio_action (const std::string& name, bool or_die = true);
+       LIBGTKMM2EXT_API extern Glib::RefPtr<Gtk::RadioAction>  get_radio_action (char const * group_name, char const * action_name, bool or_die = true);
 
-       LIBGTKMM2EXT_API extern void get_all_actions (std::vector<std::string>& names,
-                                    std::vector<std::string>& paths,
-                                    std::vector<std::string>& tooltips,
-                                    std::vector<std::string>& keys,
-                                    std::vector<Gtk::AccelKey>& bindings);
 
-       LIBGTKMM2EXT_API extern void get_all_actions (std::vector<std::string>& groups,
-                                    std::vector<std::string>& paths,
-                                    std::vector<std::string>& tooltips,
-                                    std::vector<Gtk::AccelKey>& bindings);
+       LIBGTKMM2EXT_API extern void get_all_actions (std::vector<std::string>& paths,
+                                    std::vector<std::string>& labels,
+                                    std::vector<std::string>& tooltips,
+                                    std::vector<std::string>& keys,
+                                    std::vector<Glib::RefPtr<Gtk::Action> >& actions);
 
-       LIBGTKMM2EXT_API extern void check_toggleaction (std::string);
-       LIBGTKMM2EXT_API extern void uncheck_toggleaction (std::string);
-       LIBGTKMM2EXT_API extern void set_toggleaction_state (std::string, bool);
 };
 
 #endif /* __libgtkmm2ext_actions_h__ */