add Ben Axelrod's button patch for RectangleSelector

svn path=/trunk/matplotlib/; revision=8150

Author: jdh2358

examples/widgets/rectangle_selector.py

@@ -30,5 +30,6 @@ def line_select_callback(event1, event2):
 # drawtype is 'box' or 'line' or 'none'
 LS = RectangleSelector(current_ax, line_select_callback,
                        drawtype='box',useblit=True,
+                       button = [1, 3], # don't use center mouse button
                        minspanx=5,minspany=5,spancoords='pixels')
 show()

lib/matplotlib/widgets.py

@@ -1017,7 +1017,8 @@ def toggle_selector(event):
     """
     def __init__(self, ax, onselect, drawtype='box',
                  minspanx=None, minspany=None, useblit=False,
-                 lineprops=None, rectprops=None, spancoords='data'):
+                 lineprops=None, rectprops=None, spancoords='data',
+                 button=None):
 
         """
         Create a selector in ax.  When a selection is made, clear
@@ -1047,6 +1048,15 @@ def __init__(self, ax, onselect, drawtype='box',
         spancoords is one of 'data' or 'pixels'.  If 'data', minspanx
         and minspanx will be interpreted in the same coordinates as
         the x and ya axis, if 'pixels', they are in pixels
+
+        button is a list of integers indicating which mouse buttons should
+        be used for rectangle selection.  You can also specify a single
+        integer if only a single button is desired.  Default is None, which
+        does not limit which button can be used.
+        Note, typically:
+         1 = left mouse button
+         2 = center mouse button (scroll wheel)
+         3 = right mouse button
         """
         self.ax = ax
         self.visible = True
@@ -1084,6 +1094,11 @@ def __init__(self, ax, onselect, drawtype='box',
         self.minspanx = minspanx
         self.minspany = minspany
 
+        if button is None or isinstance(button, list):
+            self.validButtons = button
+        elif isinstance(button, int):
+            self.validButtons = [button]
+            
         assert(spancoords in ('data', 'pixels'))
 
         self.spancoords = spancoords
@@ -1109,6 +1124,12 @@ def ignore(self, event):
         if not self.canvas.widgetlock.available(self):
             return True
 
+        # Only do rectangle selection if event was triggered
+        # with a desired button
+        if self.validButtons is not None:
+            if not event.button in self.validButtons:
+                return True
+            
         # If no button was pressed yet ignore the event if it was out
         # of the axes
         if self.eventpress == None: