#ifndef QHOTKEY_H #define QHOTKEY_H #include #include #include #include //! A class to define global, systemwide Hotkeys class QHotkey : public QObject { Q_OBJECT friend class QHotkeyPrivate; //! Specifies whether this hotkey is currently registered or not Q_PROPERTY(bool registered READ isRegistered WRITE setRegistered NOTIFY registeredChanged) //! Holds the shortcut this hotkey will be triggered on Q_PROPERTY(QKeySequence shortcut READ shortcut WRITE setShortcut RESET resetShortcut) public: //! Defines shortcut with native keycodes class NativeShortcut { public: quint32 key; quint32 modifier; NativeShortcut(); NativeShortcut(quint32 key, quint32 modifier = 0); bool isValid() const; bool operator ==(const NativeShortcut &other) const; bool operator !=(const NativeShortcut &other) const; private: bool valid; }; //! Constructor explicit QHotkey(QObject *parent = Q_NULLPTR); //! Constructs a hotkey with a shortcut and optionally registers it explicit QHotkey(const QKeySequence &shortcut, bool autoRegister = false, QObject *parent = Q_NULLPTR); //! Constructs a hotkey with a key and modifiers and optionally registers it explicit QHotkey(Qt::Key key, Qt::KeyboardModifiers modifiers, bool autoRegister = false, QObject *parent = Q_NULLPTR); //! Destructor ~QHotkey(); //! READ-Accessor for QHotkey::registered bool isRegistered() const; //! READ-Accessor for QHotkey::shortcut - the key and modifiers as a QKeySequence QKeySequence shortcut() const; //! READ-Accessor for QHotkey::shortcut - the key only Qt::Key keyCode() const; //! READ-Accessor for QHotkey::shortcut - the modifiers only Qt::KeyboardModifiers modifiers() const; public slots: //! WRITE-Accessor for QHotkey::registered bool setRegistered(bool registered); //! WRITE-Accessor for QHotkey::shortcut bool setShortcut(const QKeySequence &shortcut, bool autoRegister = false); //! WRITE-Accessor for QHotkey::shortcut bool setShortcut(Qt::Key key, Qt::KeyboardModifiers modifiers, bool autoRegister = false); //! RESET-Accessor for QHotkey::shortcut bool resetShortcut(); signals: //! Will be emitted if the shortcut is pressed void activated(QPrivateSignal); //! NOTIFY-Accessor for QHotkey::registered void registeredChanged(bool registered); private: Qt::Key key; Qt::KeyboardModifiers mods; NativeShortcut nativeShortcut; bool registered; }; uint qHash(const QHotkey::NativeShortcut &key); uint qHash(const QHotkey::NativeShortcut &key, uint seed); Q_DECLARE_LOGGING_CATEGORY(logQHotkey) #endif // QHOTKEY_H