--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Preferences/MouseClickDialog.py Thu Jun 25 18:42:55 2015 +0200 @@ -0,0 +1,102 @@ +# -*- coding: utf-8 -*- + +# Copyright (c) 2015 Detlev Offenbach <detlev@die-offenbachs.de> +# + +""" +Module implementing a dialog for the configuration of a mouse click sequence. +""" + +from __future__ import unicode_literals + +from PyQt5.QtCore import pyqtSlot, Qt, QEvent +from PyQt5.QtWidgets import QDialog, QDialogButtonBox + +from .Ui_MouseClickDialog import Ui_MouseClickDialog + +from Utilities import MouseUtilities + + +class MouseClickDialog(QDialog, Ui_MouseClickDialog): + """ + Class implementing a dialog for the configuration of a mouse click + sequence. + """ + def __init__(self, modifiers, button, parent=None): + """ + Constructor + + @param modifiers keyboard modifiers of the handler + @type Qt.KeyboardModifiers + @param button mouse button of the handler + @type Qt.MouseButton + @param parent reference to the parent widget + @type QWidget + """ + super(MouseClickDialog, self).__init__(parent) + self.setupUi(self) + self.setModal(True) + + self.clickGroup.installEventFilter(self) + self.clearButton.installEventFilter(self) + self.clickEdit.installEventFilter(self) + + self.buttonBox.button(QDialogButtonBox.Ok).installEventFilter(self) + self.buttonBox.button(QDialogButtonBox.Cancel).installEventFilter(self) + + self.__modifiers = modifiers + self.__button = button + + self.__showClickText() + + msh = self.minimumSizeHint() + self.resize(max(self.width(), msh.width()), msh.height()) + + @pyqtSlot() + def on_clearButton_clicked(self): + """ + Private slot to clear the entered sequence. + """ + self.__modifiers = Qt.NoModifier + self.__button = Qt.NoButton + self.__showClickText() + + def __showClickText(self): + """ + Private method to show a string representing the entered mouse click + sequence. + """ + if self.__button == Qt.NoButton: + self.clickEdit.setText("") + else: + self.clickEdit.setText(MouseUtilities.MouseButtonModifier2String( + self.__modifiers, self.__button)) + + def eventFilter(self, watched, event): + """ + Public method called to filter the event queue. + + @param watched reference to the watched object + @type QObject + @param event reference to the event that occurred + @type QEvent + @return flag indicating a handled event + @rtype bool + """ + if event.type() == QEvent.MouseButtonRelease and \ + watched == self.clickEdit: + self.__modifiers = int(event.modifiers()) + self.__button = int(event.button()) + self.__showClickText() + return True + + return False + + def getClick(self): + """ + Public method to get the entered mouse click sequence. + + @return tuple containing the modifiers and the mouse button + @rtype tuple of Qt.KeyboardModifiers and Qt.MouseButton + """ + return (self.__modifiers, self.__button)