libs/gtkmm2ext/gtkmm2ext/keyboard.h

Go to the documentation of this file.

/*
 * Copyright (C) 2001-2016 Paul Davis <paul@linuxaudiosystems.com>
 * Copyright (C) 2012 Carl Hetherington <carl@carlh.net>
 * Copyright (C) 2013 Colin Fletcher <colin.m.fletcher@googlemail.com>
 * Copyright (C) 2015-2016 Nick Mainsbridge <mainsbridge@gmail.com>
 * Copyright (C) 2015 Robin Gareus <robin@gareus.org>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program 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 General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License along
 * with this program; if not, write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */
 
#ifndef __libgtkmm2ext_keyboard_h__
#define __libgtkmm2ext_keyboard_h__
 
#include <map>
#include <string>
#include <vector>
 
#include <gtk/gtk.h>
#include <gtkmm/accelkey.h>
 
#include "pbd/signals.h"
#include "pbd/stateful.h"
 
#include "gtkmm2ext/visibility.h"
 
namespace Gtk
{
        class Window;
}
 
namespace Gtkmm2ext
{
class Bindings;
class ActionMap;
 
class LIBGTKMM2EXT_API Keyboard : public sigc::trackable, PBD::Stateful
{
public:
        Keyboard ();
        ~Keyboard ();
 
        XMLNode& get_state () const;
        int      set_state (const XMLNode&, int version);
 
        virtual void setup_keybindings () = 0;
        static void  reset_relevant_modifier_key_mask ();
 
        typedef std::vector<uint32_t> State;
        typedef uint32_t              ModifierMask;
 
        static const uint32_t PrimaryModifier;
        static const uint32_t SecondaryModifier;
        static const uint32_t TertiaryModifier;
        static const uint32_t Level4Modifier;
 
        static uint32_t CopyModifier;
        static uint32_t RangeSelectModifier;
        static uint32_t GainFineScaleModifier;
        static uint32_t GainExtraFineScaleModifier;
 
        // Modifiers for scroll wheel
        static uint32_t ScrollZoomVerticalModifier;
        static uint32_t ScrollZoomHorizontalModifier;
        static uint32_t ScrollHorizontalModifier;
 
        static const char* primary_modifier_name ();
        static const char* secondary_modifier_name ();
        static const char* tertiary_modifier_name ();
        static const char* level4_modifier_name ();
 
        static const char* primary_modifier_short_name ();
        static const char* secondary_modifier_short_name ();
        static const char* tertiary_modifier_short_name ();
        static const char* level4_modifier_short_name ();
 
        static const char* button2_name ();
        static const char* momentary_push_name ();
        static const char* group_override_event_name ();
 
        static std::string format_modifier (uint32_t);
 
        bool  key_is_down (uint32_t keyval);
        guint modifier_state ();
 
        static GdkModifierType RelevantModifierKeyMask;
 
        static bool no_modifier_keys_pressed (GdkEventButton* ev)
        {
                return (ev->state & RelevantModifierKeyMask) == 0;
        }
 
        static bool no_modifier_keys_pressed (GdkEventKey* ev)
        {
                return (ev->state & RelevantModifierKeyMask) == 0;
        }
 
        bool leave_window (GdkEventCrossing* ev, Gtk::Window*);
        bool enter_window (GdkEventCrossing* ev, Gtk::Window*);
        bool focus_in_window (GdkEventFocus* ev, Gtk::Window*);
        bool focus_out_window (GdkEventFocus* ev, Gtk::Window*);
 
        static bool modifier_state_contains (guint state, ModifierMask);
        static bool modifier_state_equals (guint state, ModifierMask);
 
        static bool no_modifiers_active (guint state);
 
        static void set_copy_modifier (uint32_t newval)
        {
                set_modifier (newval, CopyModifier);
        }
        static void set_range_select_modifier (uint32_t newval)
        {
                set_modifier (newval, RangeSelectModifier);
        }
 
        static void set_snap_modifier (guint);
        static void set_snap_delta_modifier (guint);
        static void set_edit_button (guint);
        static void set_edit_modifier (guint);
        static void set_delete_button (guint);
        static void set_delete_modifier (guint);
        static void set_insert_note_button (guint);
        static void set_insert_note_modifier (guint);
 
        static ModifierMask snap_modifier ()
        {
                return ModifierMask (snap_mod);
        }
 
        static ModifierMask snap_delta_modifier ()
        {
                return ModifierMask (snap_delta_mod);
        }
 
        static guint edit_button ()
        {
                return edit_but;
        }
        static guint edit_modifier ()
        {
                return edit_mod;
        }
        static guint delete_button ()
        {
                return delete_but;
        }
        static guint delete_modifier ()
        {
                return delete_mod;
        }
        static guint insert_note_button ()
        {
                return insert_note_but;
        }
        static guint insert_note_modifier ()
        {
                return insert_note_mod;
        }
        static guint button2_modifier ()
        {
                return button2_modifiers;
        }
        static guint momentary_push_modifier ()
        {
                return momentary_push_modifiers;
        }
        static guint group_override_modifier ()
        {
                return group_override_modifiers;
        }
 
        static bool is_edit_event (GdkEventButton*);
        static bool is_delete_event (GdkEventButton*);
        static bool is_insert_note_event (GdkEventButton*);
        static bool is_context_menu_event (GdkEventButton*);
        static bool is_button2_event (GdkEventButton*);
        static bool is_momentary_push_event (GdkEventButton*);
        static bool is_group_override_event (GdkEventButton*);
 
        static Keyboard& the_keyboard ()
        {
                return *_the_keyboard;
        }
 
        static bool         some_magic_widget_has_focus ();
        static void         magic_widget_grab_focus ();
        static void         magic_widget_drop_focus ();
        static Gtk::Window* get_current_window ()
        {
                return current_window;
        };
 
        static bool close_current_dialog ();
 
        static void        keybindings_changed ();
        static void        save_keybindings ();
        static void        set_can_save_keybindings (bool yn);
        static std::string current_binding_name ()
        {
                return _current_binding_name;
        }
        static std::map<std::string, std::string> binding_files;
 
        static bool catch_user_event_for_pre_dialog_focus (GdkEvent* ev, Gtk::Window* w);
 
        static bool load_keybindings (std::string const& path);
        static void save_keybindings (std::string const& path);
 
        static std::string binding_filename_suffix;
        static const int   close_window_key;
        static guint       close_window_modifier;
 
        int reset_bindings ();
 
        sigc::signal0<void>                      ZoomVerticalModifierReleased;
        static sigc::signal0<void>               RelevantModifierKeysChanged;
        static sigc::signal1<void, Gtk::Window*> HideMightMeanQuit;
 
protected:
        static Keyboard* _the_keyboard;
 
        guint snooper_id;
        State state;
 
        static guint        edit_but;
        static guint        edit_mod;
        static guint        delete_but;
        static guint        delete_mod;
        static guint        insert_note_but;
        static guint        insert_note_mod;
        static guint        snap_mod;
        static guint        snap_delta_mod;
        static guint        button2_modifiers;
        static guint        momentary_push_modifiers;
        static guint        group_override_modifiers;
        static Gtk::Window* current_window;
        static std::string  user_keybindings_path;
        static bool         can_save_keybindings;
        static bool         bindings_changed_after_save_became_legal;
        static std::string  _current_binding_name;
 
        typedef std::pair<std::string, std::string> two_strings;
 
        static gint _snooper (GtkWidget*, GdkEventKey*, gpointer);
        gint        snooper (GtkWidget*, GdkEventKey*);
 
        static void set_modifier (uint32_t newval, uint32_t& variable);
 
        static bool _some_magic_widget_has_focus;
 
        static Gtk::Window* pre_dialog_active_window;
 
        static int read_keybindings (std::string const& path);
        static int store_keybindings (std::string const& path);
};
 
} // namespace Gtkmm2ext
 
#endif /* __libgtkmm2ext_keyboard_h__ */