PyQt Lab est un outil puissant qui permet aux développeurs de créer des applications graphiques riches et interactives. Dans cet article, nous allons voir comment utiliser PyQt Lab pour détecter la position du curseur de souris sur un QLabel d’affichage d’une image en utilisant un eventFilter. Nous verrons comment configurer l’eventFilter et comment l’utiliser pour récupérer les coordonnées du curseur de souris et les afficher sur le QLabel. Nous verrons également comment utiliser ces informations pour créer des applications interactives et intuitives.
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 :
# 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
# -*- 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.
