applied Pauls keybinding patch

jdh2358 · jdh2358 · commit b67be9a2805c · 2008-10-22T02:02:22.000Z
svn path=/trunk/matplotlib/; revision=6291
diff --git a/doc/users/navigation_toolbar.rst b/doc/users/navigation_toolbar.rst
@@ -76,6 +76,30 @@ The ``Save`` button
     ``svg`` and ``pdf``.
 
 
+Navigation Keyboard Shortcuts
+-----------------------------
+
+================================== =====================
+Command                            Keyboard Shortcut(s)
+================================== =====================
+Home/Reset                         **h** or **r** or **home**
+Back                               **c** or **left arrow** or **backspace**
+Forward                            **v** or **right arrow** 
+Pan/Zoom                           **p**                                        
+Zoom-to-rect                       **o**                   
+Save                               **s**                   
+Toggle fullscreen                  **f**
+---------------------------------- ---------------------
+**Pan/Zoom mode only**             
+- constrain pan/zoom to x axis     hold **x**
+- constrain pan/zoom to y axis     hold **y**
+- preserve aspect ratio            hold **CONTROL**     
+---------------------------------- ---------------------
+**In axes only**
+- Toggle grid                      **g**
+- Toggle y axis scale (log/linear) **l**
+================================== =====================
+
 If you are using :mod:`matplotlib.pyplot` the toolbar will be created
 automatically for every figure.  If you are writing your own user
 interface code, you can add the toolbar as a widget.  The exact syntax
diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
@@ -1513,6 +1513,23 @@ def key_press(self, event):
 
         if event.key == 'f':
             self.full_screen_toggle()
+        
+        # *h*ome or *r*eset mnemonic
+        elif event.key == 'h' or event.key == 'r' or event.key == "home":
+            self.canvas.toolbar.home()
+        # c and v to enable left handed quick navigation
+        elif event.key == 'left' or event.key == 'c' or event.key == 'backspace':
+            self.canvas.toolbar.back()
+        elif event.key == 'right' or event.key == 'v':
+            self.canvas.toolbar.forward()
+        # *p*an mnemonic
+        elif event.key == 'p':
+            self.canvas.toolbar.pan()
+        # z*o*om mnemonic
+        elif event.key == 'o':
+            self.canvas.toolbar.zoom()
+        elif event.key == 's':
+            self.canvas.toolbar.save_figure(self.canvas.toolbar)
 
         if event.inaxes is None:
             return
