PySide6 GUI 编程（32）：QMouseEvent 鼠标事件

from __future__ import annotations

import sys
from datetime import datetime

from PySide6.QtCore import Qt
from PySide6.QtGui import QMouseEvent
from PySide6.QtWidgets import QApplication, QLabel, QMainWindow, QVBoxLayout, QWidget


def get_time_str() -> str:
    return datetime.now().isoformat(sep = ' ')


def gen_event_str(event: QMouseEvent) -> str:
    return f'Mouse Event Type:{event.type()}, Position:{event.position().toTuple()}, Time:{get_time_str()}'


class MyMainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle('Mouse Events Demo')
        self.setToolTip('A PySide6 GUI Application Demo')
        # 鼠标移动事件展示
        self.move_label = QLabel('No Movement', parent = self)
        self.move_label.setAlignment(Qt.AlignmentFlag.AlignHCenter | Qt.AlignmentFlag.AlignVCenter)
        self.move_label.setMouseTracking(True)
        # 鼠标点击事件展示
        self.clicked_label = QLabel('No Clicked Event', parent = self)
        self.clicked_label.setAlignment(Qt.AlignmentFlag.AlignHCenter | Qt.AlignmentFlag.AlignVCenter)
        self.clicked_label.setMouseTracking(True)
        # 鼠标释放事件展示
        self.released_label = QLabel('No Released Event', parent = self)
        self.released_label.setAlignment(Qt.AlignmentFlag.AlignHCenter | Qt.AlignmentFlag.AlignVCenter)
        self.released_label.setMouseTracking(True)
        # 鼠标双击事件展示
        self.double_clicked_label = QLabel('No Double Clicked Event', parent = self)
        self.double_clicked_label.setAlignment(Qt.AlignmentFlag.AlignHCenter | Qt.AlignmentFlag.AlignVCenter)
        self.double_clicked_label.setMouseTracking(True)
        # 窗口自身追踪鼠标事件
        self.setMouseTracking(True)
        # 窗口布局
        v_layout = QVBoxLayout()
        v_layout.addWidget(self.move_label)
        v_layout.addWidget(self.clicked_label)
        v_layout.addWidget(self.released_label)
        v_layout.addWidget(self.double_clicked_label)
        container = QWidget(self)
        container.setLayout(v_layout)
        self.setCentralWidget(container)

    # 需要先按下鼠标按钮再移动才能触发
    def mouseMoveEvent(self, event: QMouseEvent):
        self.move_label.setText(gen_event_str(event))
        """
        在事件处理器（如 mousePressEvent 或 keyPressEvent）中调用 event.accept() 时
        将会告诉 Qt 已经处理了这个事件，Qt 不需要再将这个事件传递给其他的事件处理器
        在大多数情况下，这意味着事件将不会继续传播到父窗口部件
        
        在事件处理器中调用 event.ignore() 时，
        将会正在告诉 Qt 您没有处理这个事件，Qt 应该将这个事件传递给其他的事件处理器
        在大多数情况下，这意味着事件将继续传播到父窗口部件，直到找到一个能够处理它的事件处理器
        
        总的来说，event.accept() 和 event.ignore() 用于控制事件的传播
        如果想阻止事件继续传播，可以调用 event.accept()
        如果想让事件继续传播，可以调用 event.ignore()
        """
        event.accept()

    def mousePressEvent(self, event: QMouseEvent):
        self.clicked_label.setText(gen_event_str(event))
        event.accept()

    def mouseReleaseEvent(self, event: QMouseEvent):
        self.released_label.setText(gen_event_str(event))
        event.accept()

    def mouseDoubleClickEvent(self, event):
        self.double_clicked_label.setText(gen_event_str(event))
        event.accept()


if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MyMainWindow()
    window.show()
    app.exec()