ToolManager
class matplotlib.backend_managers.ToolEvent(name, sender, tool, data=None)
[source]
Bases: object
Event for tool manipulation (add/remove)
class matplotlib.backend_managers.ToolManager(figure=None)
[source]
Bases: object
Helper class that groups all the user interactions for a Figure.
Attributes: |
|
---|
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, this event is fired everytime the tool is triggered.
Parameters: |
|
---|
See also
matplotlib.backend_tools.ToolBase
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: |
|
---|
get_tool_keymap(name)
[source]
Get the keymap associated with the specified tool
Parameters: |
|
---|---|
Returns: |
|
message_event(message, sender=None)
[source]
Emit a ToolManagerMessageEvent
remove_tool(name)
[source]
Remove tool from ToolManager
Parameters: |
|
---|
set_figure(figure, update_tools=True)
[source]
Bind the given figure to the tools.
Parameters: |
|
---|
toolmanager_connect(s, func)
[source]
Connect event with string s to func.
Parameters: |
|
---|
toolmanager_disconnect(cid)
[source]
Disconnect callback id cid
Example usage:
cid = toolmanager.toolmanager_connect('tool_trigger_zoom', on_press) #...later toolmanager.toolmanager_disconnect(cid)
tools
Return the tools controlled by ToolManager
trigger_tool(name, sender=None, canvasevent=None, data=None)
[source]
Trigger a tool and emit the tool_trigger_[name] event
Parameters: |
|
---|
update_keymap(name, *keys)
[source]
Set the keymap to associate with the specified tool
Parameters: |
|
---|
class 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
class 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
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.0.0/api/backend_managers_api.html