matplotlib.backend_managers#

classe matplotlib.backend_managers. ToolEvent ( name , sender , tool , data = None ) [fonte] #

Basi:object

Evento per la manipolazione degli strumenti (aggiungi/rimuovi).

classe matplotlib.backend_managers. ToolManager ( figura = Nessuno ) [fonte] #

Basi:object

Gestore per le azioni attivate dalle interazioni dell'utente (pressione di tasti, clic sulla barra degli strumenti, ...) su una figura.

Attributi :
figureFigure

Figura che sostiene la tela.

keypresslockLockDraw

LockDrawoggetto per sapere se l' canvasevento key_press_è bloccato.

messagelockLockDraw

LockDrawoggetto per sapere se il messaggio è disponibile per la scrittura.

proprietà active_toggle #

Strumenti attualmente attivati.

add_tool ( nome , strumento , * args , ** kwargs ) [fonte] #

Aggiungi strumento a ToolManager.

In caso di successo, aggiunge un nuovo evento tool_trigger_{name}dove {name}è il nome dello strumento; l'evento viene generato ogni volta che viene attivato lo strumento.

Parametri :
nome str

Il nome dello strumento, trattato come l'ID, deve essere univoco.

tipo di strumento

Classe dello strumento da aggiungere. Verrà invece utilizzata una sottoclasse se ne è stata registrata una per la classe Canvas corrente.

Guarda anche

matplotlib.backend_tools.ToolBase

La classe base per gli strumenti.

Appunti

args e kwargs vengono passati direttamente al costruttore degli strumenti.

tela di proprietà #

Tela gestita da FigureManager.

cifra della proprietà #

Figura che sostiene la tela.

get_tool ( nome , warn = True ) [fonte] #

Restituisce l'oggetto strumento con il nome specificato.

Per comodità, questo passa attraverso gli oggetti strumento.

Parametri :
nome str oToolBase

Nome dello strumento o dello strumento stesso.

warn bool, predefinito: vero

Se deve essere emesso un avviso, non esiste alcuno strumento con il nome dato.

Resi :
ToolBaseo Nessuno

Lo strumento o Nessuno se non esiste uno strumento con il nome specificato.

get_tool_keymap ( nome ) [fonte] #

Restituisce la mappa dei tasti associata allo strumento specificato.

Parametri :
nome str

Nome dello strumento.

Resi :
elenco di str

Elenco delle chiavi associate allo strumento.

message_event ( messaggio , mittente = Nessuno ) [fonte] #

Emetti un file ToolManagerMessageEvent.

remove_tool ( nome ) [fonte] #

Rimuovi lo strumento denominato name .

Parametri :
nome str

Nome dello strumento.

set_figure ( figura , update_tools = True ) [fonte] #

Associa la figura data agli strumenti.

Parametri :
figuraFigure
update_tools bool, predefinito: vero

Forza gli strumenti per aggiornare la figura.

toolmanager_connect ( s , func ) [fonte] #

Collega l'evento con la stringa s a func .

Parametri :
str _

Il nome dell'evento. Sono riconosciuti i seguenti eventi:

  • 'strumento_messaggio_evento'

  • 'tool_removed_event'

  • 'tool_added_event'

Per ogni strumento aggiunto viene creato un nuovo evento

  • 'tool_trigger_TOOLNAME', dove TOOLNAME è l'id dello strumento.

funzione richiamabile

Funzione di richiamata per l'evento toolmanager con firma:

def func(event: ToolEvent) -> Any
Resi :
cid

L'ID di richiamata per la connessione. Questo può essere utilizzato in toolmanager_disconnect.

toolmanager_disconnect ( cid ) [fonte] #

Disconnettere l'id di richiamata cid .

Esempio di utilizzo:

cid = toolmanager.toolmanager_connect('tool_trigger_zoom', onpress)
#...later
toolmanager.toolmanager_disconnect(cid)
strumenti di proprietà #

Un nome strumento di mappatura dict -> strumento controllato.

trigger_tool ( nome , mittente = Nessuno , canvasevent = Nessuno , dati = Nessuno ) [fonte] #

Attiva uno strumento ed emetti l' tool_trigger_{name}evento.

Parametri :
nome str

Nome dello strumento.

oggetto mittente

Oggetto che desidera attivare lo strumento.

canvasevent Evento

Evento Canvas originale o Nessuno.

oggetto dati

Dati aggiuntivi da passare allo strumento durante l'attivazione.

update_keymap ( nome , chiave ) [fonte] #

Imposta la mappa dei tasti da associare allo strumento specificato.

Parametri :
nome str

Nome dello strumento.

chiave str o lista di str

Chiavi da associare allo strumento.

classe matplotlib.backend_managers. ToolManagerMessageEvent ( nome , mittente , messaggio ) [fonte] #

Basi:object

Evento che trasporta messaggi da toolmanager.

I messaggi di solito vengono visualizzati all'utente dalla barra degli strumenti.

classe matplotlib.backend_managers. ToolTriggerEvent ( name , sender , tool , canvasevent = None , data = None ) [fonte] #

Basi:ToolEvent

Evento per informare che uno strumento è stato attivato.