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

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

toolтип

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

См. также

matplotlib.backend_tools.ToolBase

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

Примечания

args и kwargs передаются непосредственно конструктору инструментов.

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 — идентификатор инструмента.

funcвызываемая функция

Функция обратного вызова для события 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

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

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

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

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

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