matplotlib.backend_managers

classmatplotlib.backend_managers.ToolEvent(name, sender, tool, data=None)[source]

Bases: object

Событие для управления инструментом (добавление/удаление).

classmatplotlib.backend_managers.ToolManager(figure=None)[source]

Основы: object

Менеджер для действий, вызываемых пользовательскими взаимодействиями (нажатие клавиш, щелчки по инструментам панели инструментов и т.д.) на рисунке.

Атрибуты:

figureFigure

Рисунок, содержащий холст.

keypresslockLockDraw

Объект LockDraw, чтобы узнать, заблокирован ли canvas key_press_event.

messagelockLockDraw

Объект LockDraw, чтобы узнать, доступно ли сообщение для записи.

propertyactive_toggle

Текущие переключенные инструменты.

add_tool(name, tool, *args, **kwargs)[source]

Добавить tool в ToolManager.

При успехе добавляется новое событие tool_trigger_{name}, где {name} — имя инструмента; событие срабатывает каждый раз, когда инструмент используется.

Параметры:

namestr

Имя инструмента, рассматриваемое как идентификатор, должно быть уникальным.

tooltype

Класс добавляемого инструмента. Будет использован подкласс, если он зарегистрирован для текущего класса холста.

*args, **kwargs

Передаются в конструктор tool.

См. также

matplotlib.backend_tools.ToolBase

Базовый класс для инструментов.

propertycanvas

Холст, управляемый FigureManager.

propertyfigure

Рисунок, содержащий холст.

get_tool(name, warn=True)[source]

Возвращает объект инструмента с заданным именем.

Для удобства, это пропускает объекты инструментов.

Параметры:

namestr или ToolBase

Имя инструмента или сам инструмент.

warnbool, по умолчанию: True

Выводить ли предупреждение, если инструмент с заданным именем не существует.

Возвращает:

ToolBase или None

Инструмент или None, если инструмент с заданным именем не существует.

get_tool_keymap(name)[source]

Возвращает сопоставление клавиш, связанное с указанным инструментом.

Параметры:

namestr

Имя инструмента.

Возвращает:

список str

Список клавиш, связанных с инструментом.

message_event(message, sender=None)[source]

Вызывает событие ToolManagerMessageEvent.

remove_tool(name)[source]

Удалить инструмент с именем name.

Параметры:

namestr

Имя инструмента.

set_figure(figure, update_tools=True)[source]

Связать данный рисунок с инструментами.

Параметры:

figureFigure

update_toolsbool, по умолчанию: True

Вынудительно обновить инструменты.

toolmanager_connect(s, func)[source]

Подключить событие со строкой s к func.

Параметры:

sstr

Имя события. Распознаются следующие события:

• 'tool_message_event'
• 'tool_removed_event'
• 'tool_added_event'

Для каждого добавленного инструмента создается новое событие

• 'tool_trigger_TOOLNAME', где TOOLNAME — идентификатор инструмента.

funccallable

Функция обратного вызова для события toolmanager с подписью:

def func(event: ToolEvent) -> Any

Возвращает:

cid

Идентификатор обратного вызова для подключения. Его можно использовать в toolmanager_disconnect.

toolmanager_disconnect(cid)[source]

Отключение обратного вызова с идентификатором cid.

Пример использования:

cid = toolmanager.toolmanager_connect('tool_trigger_zoom', onpress)
#...later
toolmanager.toolmanager_disconnect(cid)

propertytools

Словарь, отображающий имя инструмента -> управляемый инструмент.

trigger_tool(name, sender=None, canvasevent=None, data=None)[source]

Вызвать инструмент и выпустить событие tool_trigger_{name}.

Параметры:

namestr

Имя инструмента.

senderobject

Объект, который хочет вызвать инструмент.

canvaseventEvent

Исходное событие холста или None.

dataobject

Дополнительные данные для передачи инструменту при вызове.

update_keymap(name, key)[source]

Установить сопоставление клавиш для указанного инструмента.

Параметры:

namestr

Имя инструмента.

keystr или список str

Клавиши, которые нужно сопоставить с инструментом.

classmatplotlib.backend_managers.ToolManagerMessageEvent(name, sender, message)[source]

Базовые классы: object

Событие, содержащее сообщения от toolmanager.

Сообщения обычно отображаются пользователю с помощью панели инструментов.

classmatplotlib.backend_managers.ToolTriggerEvent(name, sender, tool, canvasevent=None, data=None)[source]

Базовые классы: ToolEvent

Событие, информирующее о том, что инструмент был вызван.