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

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

Возвращает:

list из 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

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