matplotlib.pyplot.connect#

matplotlib.pyplot.connect(s, func)[source]#

将函数 func 绑定到事件 s

参数:
sstr

以下事件 ID 之一

  • 'button_press_event'

  • 'button_release_event'

  • 'draw_event'

  • 'key_press_event'

  • 'key_release_event'

  • 'motion_notify_event'

  • 'pick_event'

  • 'resize_event'

  • 'scroll_event'

  • 'figure_enter_event',

  • 'figure_leave_event',

  • 'axes_enter_event',

  • 'axes_leave_event'

  • 'close_event'.

funccallable

待执行的回调函数,其必须具有以下签名

def func(event: Event) -> Any

对于位置事件(按钮和按键的按下/释放),如果鼠标位于坐标轴(Axes)之上,事件的 inaxes 属性将被设置为事件发生所在的 Axes,此外,xdataydata 属性将被设置为数据坐标系下的鼠标位置。更多信息请参阅 KeyEventMouseEvent

注意

如果 func 是一个方法,则此处仅存储该方法的弱引用。因此,Figure 不会影响关联对象的生命周期。通常,您需要通过持有对象的引用来确保该对象在 Figure 的整个生命周期内保持存活。

返回:
cid

一个连接 ID,可用于 FigureCanvasBase.mpl_disconnect

备注

示例

def on_press(event):
    print('you pressed', event.button, event.xdata, event.ydata)

cid = canvas.mpl_connect('button_press_event', on_press)

使用 matplotlib.pyplot.connect 的示例#

鼠标移动和点击事件

鼠标移动和点击事件