README.md

QtGlobalInput

QtGlobalInput is small library that implements windows global hooks in Qt.

Structure

All funktions in QtGlobalInput are static and should be called with

QtGlobalInput::functionName()

Init and deinitialize

Initialization

Before creating hooks, QtGlobalInput must be initialized with

QtGlobalInput::init(hwnd)

Example:

QtGlobalInput::init((HWND)MainWindow::winId());

Deinitialization

If you don't need hooks anymore, you can deinialize QtGlobalInput with

QtGlobalInput::deinitialize()

Set

All funktions are returning hook id. With this id hook can be removed.

EventType

enum class EventType
{
    All,
    ButtonDown,
    ButtonUp
};

setLlKeyboardHook

static uint setLlKeyboardHook(uint vkCode, EventType type, A callback, B obj, bool async = false);

1. vkCode - vkCode of the key you want to hook. If vkCode is 0, will hook all key presses
2. type - decides if should listen to key down or key up
3. callback - funktion that will be called when hook triggers. Should have form:

void function(int nCode, WPARAM wParam, LPARAM lParam)

4. obj - object that has callback funktion
5. async - if true, callback funktion will be called asynchronous

waitForKeyPress

static uint waitForKeyPress(uint vkCode, EventType type, A callback, B obj, bool async = false);

1. vkCode - vkCode of the key you want to hook. If vkCode is 0, will hook all key presses
2. type - decides if should listen to key down or key up
3. callback - funktion that will be called when hook triggers. Should have form:

void function(RAWKEYBOARD rawkeyboard)

4. obj - object that has callback funktion
5. async - if true, callback funktion will be called asynchronous

wairForMousePress

static uint waitForMousePress(uint vkCode, EventType type, A callback, B obj, bool async = false);

1. vkCode - vkCode of the key you want to hook. If vkCode is 0, will hook all key presses
2. type - decides if should listen to key down or key up
3. callback - funktion that will be called when hook triggers. Should have form:

void function(RAWMOUSE rawmouse)

4. obj - object that has callback funktion
5. async - if true, callback funktion will be called asynchronous

setWindowSwitch

static uint setWindowSwitch(A callback, B obj)

1. callback - funktion that will be called when hook triggers. Should have form - void function(HWND hwnd)
2. obj - object that has callback funktion

Remove

This funktions will remove hook by his id and return true if hook is successfully deleted.

1. static bool removeLlKeyboardHook(uint id);
2. static bool removeKeyPress(uint id);
3. static bool removeMousePress(uint id);
4. static bool removeWindowSwitch(uint id);

Example

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
  ui->setupUi(this);
  QtGlobalInput::init((HWND)MainWindow::winId());
  uint keyPressId = QtGlobalInput::waitForKeyPress(0, EventType::ButtonUp, &MainWindow::handleKey, this, true);
  uint windowSwitchId = QtGlobalInput::setWindowSwitch(&MainWindow::windowSwitched, this);
}

void MainWindow::windowSwitched(HWND hwnd) { ... }

void MainWindow::handleKey(RAWKEYBOARD keyboard) { ... }