Initial implementation of shortcut to windows

[PURPOSE]

In editors such as vi and emacs, a user can mark a line in a file with
a shortcut key and afterwards jump back to that line using the shortcut.

The idea is extended to opened windows. A user can assign a keyboard
shortcut to an opened window.  Afterwards, the shortcut can be used to
switch focus back to the marked window.

Such shortcuts save the user from pressing "alt+tab" multiple times to
cycle through windows until the desired one is found.

[EXAMPLE USAGE]

The following binding is added to file "~/.fluxbox/keys":

    Mod1 m ARG :MarkWindow

    Mod1 g ARG :GotoMarkedWindow

User enters "alt+m x" to mark the currently focused window with shortcut
key 'x'

User enters "alt+g x" to switch focus to the marked window

[IMPLEMENTATION SUMMARY]

- Two new commands were added :MarkWindow and :GotoMarkedWindow

- Keys.cc was modified:
    - addBinding() method supports parsing an argument placeholder where
      the user can pass in a shortcut key
    - doAction() method forwards the shortcut key to the command to execute
    - Class Keys::t_key was modified to recognize a placeholder key

- New class ShortcutManager was added to maintain mapping of shortcut
  keys to marked windows

1 files changed, 37 insertions, 0 deletions

diff --git a/src/WorkspaceCmd.cc b/src/WorkspaceCmd.cc
index 6d18b73..c2e4948 100644
--- a/src/WorkspaceCmd.cc
+++ b/src/WorkspaceCmd.cc
@@ -39,6 +39,8 @@
 #include "FbTk/stringstream.hh"
 #include "FbTk/StringUtil.hh"
 
+#include "Debug.hh"
+
 #ifdef HAVE_CMATH
   #include <cmath>
 #else
@@ -751,3 +753,38 @@ FbTk::Command<void> *RelabelButtonCmd::parse(const std::string &command,
 
 REGISTER_COMMAND_PARSER(relabelbutton, RelabelButtonCmd::parse, void);
 
+void MarkWindowCmd::execute() {
+    BScreen *screen = Fluxbox::instance()->keyScreen();
+    if (screen) {
+
+        FluxboxWindow* window = screen->focusControl().focusedFbWindow();
+        if (window) {
+            ShortcutManager &shortcutManager = Fluxbox::instance()->shortcutManager();
+            unsigned int key = shortcutManager.getLastPlaceHolderKey();
+            shortcutManager.mapKeyToWindow(key, window);
+            fbdbg << "Map window[" << window << "] to key[" << key << "]" << std::endl;
+        }
+    }
+}
+
+REGISTER_COMMAND(markwindow, MarkWindowCmd, void);
+
+void GotoMarkedWindowCmd::execute() {
+
+    ShortcutManager &shortcutManager = Fluxbox::instance()->shortcutManager();
+    unsigned int key = shortcutManager.getLastPlaceHolderKey();
+
+    FluxboxWindow *window = shortcutManager.getWindowForKey(key);
+    if (window) {
+
+        if (window->isIconic()) {
+            window->deiconify(false);
+        }
+        window->raiseAndFocus();
+
+        fbdbg << "Raise and focus window[" << window
+              << "] mapped to key[" << key << "]" << std::endl;
+    }
+}
+
+REGISTER_COMMAND(gotomarkedwindow, GotoMarkedWindowCmd, void);