matplotlib.backend_managers
¶matplotlib.backend_managers.
ToolEvent
(name, sender, tool, data=None)[source]¶Bases: object
Event for tool manipulation (add/remove).
matplotlib.backend_managers.
ToolManager
(figure=None)[source]¶Bases: object
Manager for actions triggered by user interactions (key press, toolbar clicks, ...) on a Figure.
Attributes
figure |
Figure that holds the canvas. |
keypresslock | (widgets.LockDraw ) LockDraw object to know if the canvas key_press_event is locked |
messagelock | (widgets.LockDraw ) LockDraw object to know if the message is available to write |
active_toggle
¶Currently toggled tools.
add_tool
(name, tool, *args, **kwargs)[source]¶Add tool to ToolManager
.
If successful, adds a new event tool_trigger_{name}
where
{name}
is the name of the tool; the event is fired everytime the
tool is triggered.
Parameters: | name : str
tool : class_like, i.e. str or type
|
---|
See also
matplotlib.backend_tools.ToolBase
Notes
args and kwargs get passed directly to the tools constructor.
canvas
¶Canvas managed by FigureManager.
figure
¶Figure that holds the canvas.
get_tool
(name, warn=True)[source]¶Return the tool object, also accepts the actual tool for convenience.
Parameters: | name : str, ToolBase
warn : bool, optional
|
---|
get_tool_keymap
(name)[source]¶Get the keymap associated with the specified tool.
Parameters: | name : string
|
---|---|
Returns: | list : list of keys associated with the Tool |
message_event
(message, sender=None)[source]¶Emit a ToolManagerMessageEvent
.
set_figure
(figure, update_tools=True)[source]¶Bind the given figure to the tools.
Parameters: | figure : update_tools : bool
|
---|
toolmanager_connect
(s, func)[source]¶Connect event with string s to func.
Parameters: | s : String
func : function
|
---|
toolmanager_disconnect
(cid)[source]¶Disconnect callback id cid.
Example usage:
cid = toolmanager.toolmanager_connect('tool_trigger_zoom', onpress)
#...later
toolmanager.toolmanager_disconnect(cid)
tools
¶A dict mapping tool name -> controlled tool.
trigger_tool
(name, sender=None, canvasevent=None, data=None)[source]¶Trigger a tool and emit the tool_trigger_{name}
event.
Parameters: | name : string
sender : object
canvasevent : Event
data : Object
|
---|
matplotlib.backend_managers.
ToolManagerMessageEvent
(name, sender, message)[source]¶Bases: object
Event carrying messages from toolmanager.
Messages usually get displayed to the user by the toolbar.
matplotlib.backend_managers.
ToolTriggerEvent
(name, sender, tool, canvasevent=None, data=None)[source]¶Bases: matplotlib.backend_managers.ToolEvent
Event to inform that a tool has been triggered.