View  Edit  Attributes  History  Attach  Print  Search

PYQTLAB

PyQt Lab' : Détecter la position du curseur de souris sur un QLabel d'affichage d'une image en utilisant un eventFilter

Par X. HINAULT - Juin 2013

Ce que l'on va faire ici

  • Nous allons ici poser les bases de l'interactivité à la souris avec une image : le code PyQt que je propose ici se contente d'intercepter l'événement "mouseMove" ou "mouseButtonPress" qui surviennent sur un QLabel. On récupérera la position de la souris ainsi que le bouton cliqué le cas échéant.
  • Le principe ici va consister à utiliser la fonction installEventFilter() de la classe QObject qui va permettre l'appel d'une fonction lors de la survenue d'un événement sur le QLabel, la fonction eventFilter() au niveau de laquelle seront analysés les événements survenus. Les actions voulues seront effectuées en conséquence.
  • La fonction eventFilter() reçoit l'objet déclencheur et l'événement filtré : l'objet QMouseEvent permet d'accéder aux coordonnées du point avec la méthode pos(). Il est également d'analyser le type de l'événement. Voir http://pyqt.sourceforge.net/Docs/PyQt4/qmouseevent.html
  • Ce code servira de base pour toutes les interfaces nécessitant d'interagir simplement avec une image.

Pré-requis

  • python 2.7
  • pyqt4.x

Le fichier d'interface *.py

  • Fichier obtenu automatiquement avec l'utilitaire pyuic4 à partir du fichier *.ui créé avec QtDesigner :
# -*- coding: utf-8 -*-

# Form implementation generated from reading ui file
#
# Created: Wed Jun 12 18:56:04 2013
#      by: PyQt4 UI code generator 4.9.1
#
# WARNING! All changes made in this file will be lost!

from PyQt4 import QtCore, QtGui

try:
    _fromUtf8 = QtCore.QString.fromUtf8
except AttributeError:
    _fromUtf8 = lambda s: s

class Ui_Form(object):
    def setupUi(self, Form):
        Form.setObjectName(_fromUtf8("Form"))
        Form.resize(333, 258)
        Form.setMouseTracking(True)
        self.label = QtGui.QLabel(Form)
        self.label.setGeometry(QtCore.QRect(5, 10, 320, 240))
        self.label.setStyleSheet(_fromUtf8("background-color: rgb(255, 255, 255);"))
        self.label.setText(_fromUtf8(""))
        self.label.setObjectName(_fromUtf8("label"))

        self.retranslateUi(Form)
        QtCore.QMetaObject.connectSlotsByName(Form)

    def retranslateUi(self, Form):
        Form.setWindowTitle(QtGui.QApplication.translate("Form", "Pyqt : Position curseur souris sur QLabel", None, QtGui.QApplication.UnicodeUTF8))


if __name__ == "__main__":
    import sys
    app = QtGui.QApplication(sys.argv)
    Form = QtGui.QWidget()
    ui = Ui_Form()
    ui.setupUi(Form)
    Form.show()
    sys.exit(app.exec_())

 

Le fichier d'application *Main.py


#!/usr/bin/python
# -*- coding: utf-8 -*-

# par X. HINAULT - Mai 2013 - Tous droits réservés
# GPLv3 - www.mon-club-elec.fr

# modules a importer
from PyQt4.QtGui import *
from PyQt4.QtCore import *  # inclut QTimer..
import os,sys

from  tuto_pyqt_mouse_move_label_position import * # fichier obtenu à partir QtDesigner et pyuic4

# +/- variables et objets globaux

class myApp(QWidget, Ui_Form): # la classe reçoit le Qwidget principal ET la classe définie dans test.py obtenu avec pyuic4
        def __init__(self, parent=None):
                QWidget.__init__(self) # initialise le Qwidget principal
                self.setupUi(parent) # Obligatoire

                # --- Variables de classe

                # --- Paramétrage des widgets de l'interface GUI si nécessaire ---

                # --- Connexions entre signaux des widgets et fonctions
                # connecte chaque signal utilisé des objets à l'appel de la fonction voulue

                # --- Code actif initial  ---

                #----- initialisation capture évènement souris du Qlabel
                self.label.setMouseTracking(True) # active le suivi position souris
                self.label.installEventFilter(self) # défini un objet dans cette classe pour "filtrer" les évènements en provenance de l'objet label - méthode classe Object


        # --- les fonctions appelées, utilisées par les signaux des widgets ---

        # --- les fonctions appelées, utilisées par les signaux hors widgets ---

        # fonction pour gérer filtrage évènements
        #def eventFilter(self, _, event): # fonction pour gérer filtrage évènements
        def eventFilter(self, srcEvent, event): # fonction pour gérer filtrage évènements - reçoit l'objet source de l'évènement
                print ("event ")
                #print srcEvent

                if srcEvent==self.label: # teste si la source de l'évènement est bien le label - utile si plusieurs sources d'évènements activées
                        if event.type() == QEvent.MouseMove: # si évènement "mouvement de la souris"
                                x=event.pos().x() # coordonnée souris au moment évènement dans le widget source de l'évènement =
                                y=event.pos().y()
                                print ("MouseMove : x="+ str(x) + " y= " + str(y)) # affiche coordonnées

                        elif event.type()==QEvent.MouseButtonPress: # si évènement "bouton souris appuyé"
                                if event.button()==Qt.RightButton: print "Bouton droit : ", # la fonction button de l'évènement QMouseEvent renvoie le QMouseButton
                                # Qt.RightButton est une constante
                                elif event.button()==Qt.LeftButton: print "Bouton gauche : ", # la fonction button de l'évènement QMouseEvent renvoie le QMouseButton
                                print ("x="+str(event.pos().x())+" y="+str(event.pos().y()))

                        # pour la liste des QEvent : voir : http://pyqt.sourceforge.net/Docs/PyQt4/qevent.html

                return False # obligatoire...

        # --- fonctions de classes autres---    

# -- Autres Classes utiles --

# -- Classe principale (lancement)  --
def main(args):
        a=QApplication(args) # crée l'objet application
        f=QWidget() # crée le QWidget racine
        c=myApp(f) # appelle la classe contenant le code de l'application
        f.show() # affiche la fenêtre QWidget
        r=a.exec_() # lance l'exécution de l'application
        return r

if __name__=="__main__": # pour rendre le code exécutable
        main(sys.argv) # appelle la fonction main
 

Utilisation

  • Les 2 fichiers suivants sont à enregistrer dans un même répertoire, l'un en nom.py et l'autre en nomMain.py.
  • Puis lancer l'application depuis Geany ou équivalent, en exécutant le fichier nomMain.py
  • Ensuite passer la souris sur le QLabel et voir que l'événement intercepté est affiché dans la console. Idem pour les clics droit et gauche sur la souris.
  • Remarquer que le déplacement de la souris hors du QLabel reste sans effet.