| 123456789101112131415161718192021222324252627282930 |
- def blocking_input_loop(figure, event_names, timeout, handler):
- """
- Run *figure*'s event loop while listening to interactive events.
- The events listed in *event_names* are passed to *handler*.
- This function is used to implement `.Figure.waitforbuttonpress`,
- `.Figure.ginput`, and `.Axes.clabel`.
- Parameters
- ----------
- figure : `~matplotlib.figure.Figure`
- event_names : list of str
- The names of the events passed to *handler*.
- timeout : float
- If positive, the event loop is stopped after *timeout* seconds.
- handler : Callable[[Event], Any]
- Function called for each event; it can force an early exit of the event
- loop by calling ``canvas.stop_event_loop()``.
- """
- if figure.canvas.manager:
- figure.show() # Ensure that the figure is shown if we are managing it.
- # Connect the events to the on_event function call.
- cids = [figure.canvas.mpl_connect(name, handler) for name in event_names]
- try:
- figure.canvas.start_event_loop(timeout) # Start event loop.
- finally: # Run even on exception like ctrl-c.
- # Disconnect the callbacks.
- for cid in cids:
- figure.canvas.mpl_disconnect(cid)
|
