偵測滑鼠事件

這篇教學會介紹在 PyQt5 的視窗裡，偵測滑鼠的按下、放開、移動、捲動等事件，並根據滑鼠事件，進行簡單的互動應用。

快速導覽：

• 常用的滑鼠事件
• 偵測事件後可以取得的數值
• 改用 class 的寫法

• PyQt6 版本參考：PyQt6 教學 - 偵測滑鼠事件
• 因為 Google Colab 不支援 PyQt5，所以請使用本機環境 ( 參考：使用 Python 虛擬環境 ) 或使用 Anaconda Jupyter 進行實作 ( 參考：使用 Anaconda )。

常用的滑鼠事件

建立 PyQt5 的 Widget 元件之後，只要套用對應的偵測方法，就可以偵測滑鼠的事件 ( 按下、放開、移動...等 )，下方列出常用的滑鼠事件：

以下方的程式碼執行後，會開啟一個空白的視窗，在視窗裡按下滑鼠時，後台就會印出 press 的文字 ( 注意，對應事件的函式需要包含一個 self 參數 )。

from PyQt5 import QtWidgets
import sys

app = QtWidgets.QApplication(sys.argv)

Form = QtWidgets.QWidget()
Form.setWindowTitle('oxxo.studio')
Form.resize(300, 200)

def mousePress(self):
    print('press')

Form.mousePressEvent  = mousePress    # 新增按下滑鼠事件，事件發生時執行 mousePress 函式

Form.show()
sys.exit(app.exec_())

以下方的程式碼執行後，當滑鼠在視窗中移動時，會透過 QLabel 顯示目前滑鼠的座標。

from PyQt5 import QtWidgets
import sys

app = QtWidgets.QApplication(sys.argv)

Form = QtWidgets.QWidget()
Form.setWindowTitle('oxxo.studio')
Form.resize(300, 200)

def mousePress(self):
    print('press')

Form.mousePressEvent  = mousePress

label = QtWidgets.QLabel(Form)
label.setGeometry(10,10,100,50)
label.setStyleSheet('font-size:24px;')

def mouseMove(self):
    label.setText(f'{self.x()}, {self.y()}')   # 透過 QLabel 顯示滑鼠座標

Form.setMouseTracking(True)        # 設定不需要按下滑鼠，就能偵測滑鼠移動
Form.mouseMoveEvent  = mouseMove   # 滑鼠移動事件發生時，執行 mouseMove 函式

Form.show()
sys.exit(app.exec_())

偵測事件後可以取得的數值

取的滑鼠事件後，就能透過下列的方法，取得常用的幾個滑鼠數值。

下方的例子執行後，會使用 QLabel 顯示按下哪個滑鼠按鍵。

from PyQt5 import QtWidgets
import sys

app = QtWidgets.QApplication(sys.argv)

Form = QtWidgets.QWidget()
Form.setWindowTitle('oxxo.studio')
Form.resize(300, 200)

label = QtWidgets.QLabel(Form)
label.setGeometry(10,10,100,50)
label.setStyleSheet('font-size:24px;')

def mousePress(self):
    print(self.button())
    if self.button() == 1:
        label.setText('按下左鍵')
    elif self.button() == 2:
        label.setText('按下右鍵')
    else:
        label.setText('')

Form.mousePressEvent  = mousePress    # 新增按下滑鼠事件，事件發生時執行 mousePress 函式

Form.show()
sys.exit(app.exec_())

改用 class 的寫法

上方的程式碼，亦可改用 class 的寫法表示，比較需要注意的是要使用 event。

from PyQt5 import QtWidgets
import sys

class MyWidget(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle('oxxo.studio')
        self.resize(300, 200)
        self.ui()

    def ui(self):
        self.label = QtWidgets.QLabel(self)
        self.label.setGeometry(10,10,100,50)
        self.label.setStyleSheet('font-size:24px;')

    def mousePressEvent(self, event):
        print(event.button())
        if event.button() == 1:
            self.label.setText('按下左鍵')
        elif event.button() == 2:
            self.label.setText('按下右鍵')
        else:
            self.label.setText('')

if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv)
    Form = MyWidget()
    Form.show()
    sys.exit(app.exec_())

意見回饋

如果有任何建議或問題，可傳送「意見表單」給我，謝謝～