彻底改版2.0

third/3rd_qhotkey/qhotkey.h

@@ -0,0 +1,111 @@
+#ifndef QHOTKEY_H
+#define QHOTKEY_H
+
+#include <QObject>
+#include <QKeySequence>
+#include <QPair>
+
+#ifdef QHOTKEY_LIB
+#ifdef QHOTKEY_LIB_BUILD
+#define QHOTKEY_SHARED_EXPORT Q_DECL_EXPORT
+#else
+#define QHOTKEY_SHARED_EXPORT Q_DECL_IMPORT
+#endif
+#else
+#define QHOTKEY_SHARED_EXPORT
+#endif
+
+//! A class to define global, systemwide Hotkeys
+class QHOTKEY_SHARED_EXPORT 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 QHOTKEY_SHARED_EXPORT NativeShortcut
+    {
+    public:
+        //! The native keycode
+        quint32 key;
+        //! The native modifiers
+        quint32 modifier;
+
+        //! Creates an invalid native shortcut
+        NativeShortcut();
+        //! Creates a valid native shortcut, with the given key and modifiers
+        NativeShortcut(quint32 key, quint32 modifier = 0);
+
+        //! Checks, whether this shortcut is valid or not
+        bool isValid() const;
+
+        //! Equality operator
+        bool operator ==(const NativeShortcut &other) const;
+        //! Inequality operator
+        bool operator !=(const NativeShortcut &other) const;
+
+    private:
+        bool valid;
+    };
+
+    //! Constructor
+    explicit QHotkey(QObject *parent = 0);
+    //! Constructs a hotkey with a shortcut and optionally registers it
+    explicit QHotkey(const QKeySequence &shortcut, bool autoRegister = false, QObject *parent = 0);
+    //! Constructs a hotkey with a key and modifiers and optionally registers it
+    explicit QHotkey(Qt::Key keyCode, Qt::KeyboardModifiers modifiers, bool autoRegister = false, QObject *parent = 0);
+    //! Constructs a hotkey from a native shortcut and optionally registers it
+    explicit QHotkey(const NativeShortcut &shortcut, bool autoRegister = false, QObject *parent = 0);
+    //! 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;
+
+    //! Get the current native shortcut
+    NativeShortcut currentNativeShortcut() 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 keyCode, Qt::KeyboardModifiers modifiers, bool autoRegister = false);
+    //! RESET-Accessor for QHotkey::shortcut
+    bool resetShortcut();
+
+    //! Set this hotkey to a native shortcut
+    bool setNativeShortcut(NativeShortcut nativeShortcut, bool autoRegister = false);
+
+signals:
+    //! Will be emitted if the shortcut is pressed
+    void activated();
+
+    //! NOTIFY-Accessor for QHotkey::registered
+    void registeredChanged(bool registered);
+
+private:
+    Qt::Key _keyCode;
+    Qt::KeyboardModifiers _modifiers;
+
+    NativeShortcut _nativeShortcut;
+    bool _registered;
+};
+
+uint QHOTKEY_SHARED_EXPORT qHash(const QHotkey::NativeShortcut &key);
+uint QHOTKEY_SHARED_EXPORT qHash(const QHotkey::NativeShortcut &key, uint seed);
+
+#endif // QHOTKEY_H