matplotlib事件處理基礎(事件綁定、事件屬性)

Posted on by

談到用戶界面交互總少不瞭事件，前面一系列文章介紹的鼠標光標、坐標、彈出式提示框等實現的底層其實都是事件處理，隻不過matplotlib或其他包做瞭封裝以便於應用。

matplotlib的事件處理模型基於GTK，matplotlib支持與wxpython、 tkinter、 qt、gtk等常見GUI後端的交互。

事件綁定

matplotlib的事件綁定有三個要素：

  • canvas對象
  • 事件名稱
  • 回調函數

matplotlib的事件綁定由canvas對象調用mpl_connect方法實現，mpl_connect方法有兩個參數：事件名稱、回調函數。即canvas對象.mpl_connect(事件名稱，回調函數)

mpl_connect方法又稱為事件管理器，它是FigureCanvasBase類的方法。FigureCanvasBase類屬於matplotlib.backend_bases模塊，作用是隔離繪圖和後端底層，這樣繪圖時就不用考慮各個後端之間的差異。

canvas原意畫佈，figure原意圖像，可以這樣理解，figure是一切可見繪圖元素的集合，而canvas是figure的容器，canvas的事件的響應、處理都是基於canvas的。

下面通過一個案例來簡單說明事件綁定的應用。

import matplotlib.pyplot as plt

fig, ax = plt.subplots()
ax.plot([1,1])

def onclick(event):
  print('%s click: button=%d, x=%d, y=%d, xdata=%f, ydata=%f' %
     ('double' if event.dblclick else 'single', event.button,
      event.x, event.y, event.xdata, event.ydata))

cid = fig.canvas.mpl_connect('button_press_event', onclick)

plt.show()

運行後，在圖像界面上單擊鼠標，控制臺會出現如下輸出。

single click: button=1, x=123, y=80, xdata=0.222531, ydata=0.960511

在本案例中，fig為figure對象，fig的canvas屬性可以返回當前圖像所在的canvas對象，然後再調用mpl_connect方法，’button_press_event’為鼠標左鍵單擊事件，onclick為回調函數。

事件

matplotlib中用到的事件類都繼承自matplotlib.backend_bases.Event，主要事件如下表所示。

事件名稱 類 描述
‘button_press_event’ MouseEvent 鼠標按鍵被按下
‘button_release_event’ MouseEvent 鼠標按鍵被釋放
‘draw_event’ DrawEvent 畫佈繪圖
‘key_press_event’ KeyEvent 鍵盤按鍵被按下
‘key_release_event’ KeyEvent 鍵盤按鍵被釋放
‘motion_notify_event’ MouseEvent 鼠標移動
‘pick_event’ PickEvent 畫佈中的對象被選中
‘resize_event’ ResizeEvent 圖形畫佈大小改變
‘scroll_event’ MouseEvent 鼠標滾輪被滾動
‘figure_enter_event’ LocationEvent 鼠標進入新的圖形
‘figure_leave_event’ LocationEvent 鼠標離開圖形
‘axes_enter_event’ LocationEvent 鼠標進入新的軸域
‘axes_leave_event’ LocationEvent 鼠標離開軸域

事件屬性

因為matplotlib中用到的事件類都繼承自matplotlib.backend_bases.Event，所以所有事件都擁有以下3個共同屬性。
name：事件名稱。
canvas：生成事件的canvas對象。
guiEvent：觸發matplotlib事件的GUI事件，默認為None。
所有事件均定義在matplotlib.backend_bases模塊中，其中常用的鼠標事件MouseEvent、鍵盤事件KeyEvent都繼承自LocationEvent事件。LocationEvent事件有5個屬性。

  • x：x 位置，距離畫佈左端的像素數
  • y：y 位置，距離畫佈底端的像素數
  • inaxes：是否處於坐標系中，是則為鼠標所處於的子圖實例，否則為None
  • xdata：鼠標的x坐標
  • ydata：鼠標的y坐標

鍵盤事件KeyEvent除繼承自LocationEvent事件的5個屬性外，還有1個key屬性，表示按下的鍵，值范圍為：None、任何字符、’shift’、win或者control。
鼠標事件MouseEvent 除繼承自LocationEvent事件的5個屬性外，還有以下屬性

  • key：表示鼠標事件觸發時按下的鍵，值范圍同鍵盤事件KeyEvent中的key屬性。
  • button：表示按下的鼠標按鈕，值范圍為：None、1、2、3、up、down（up、down用於滾動事件）。
  • dblclick：表示是否雙擊，佈爾值。

鼠標事件案例

鼠標點擊畫線，將鼠標點擊相鄰兩點用直線連接，起始點為0,0。

from matplotlib import pyplot as plt

class LineBuilder:
  def __init__(self, line):
    self.line = line
    self.xs = list(line.get_xdata())
    self.ys = list(line.get_ydata())
    self.cid = line.figure.canvas.mpl_connect('button_press_event', self)

  def __call__(self, event):
    print('click', event)
    if event.inaxes!=self.line.axes: return
    self.xs.append(event.xdata)
    self.ys.append(event.ydata)
    self.line.set_data(self.xs, self.ys)
    self.line.figure.canvas.draw()

fig = plt.figure()
ax = fig.add_subplot(111)
ax.set_title('click to build line segments')
line, = ax.plot([0], [0]) # empty line
linebuilder = LineBuilder(line)

plt.show()

到此這篇關於matplotlib事件處理基礎(事件綁定、事件屬性)的文章就介紹到這瞭,更多相關matplotlib 事件處理內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！

推薦閱讀：