Функционал WinAPI позволяет на низком уровне с помощью хуков отслеживать события системы, такие как движение и клики мыши. Данный функционал работает на основе функций callback, поэтому если хочется использовать ООП и систему сигналов и слотов , то нужно будет один из методов передавать в качестве функции callback в функцию по регистрации callback в системе Windows. Но метод должен быть статическим, поэтому требуется разрабатывать класс в качестве Синглтона.
SetWindowsHookEx
Данная функция используется для регистрации функции-обработчика событий в цепочке hook-обработчиков для отслеживания некоторых событий в системе Windows
HHOOK WINAPI SetWindowsHookEx( _In_ int idHook, _In_ HOOKPROC lpfn, _In_ HINSTANCE hMod, _In_ DWORD dwThreadId );
Параметры
idHook [in]
Тип: int
Тип хука, который был установлен. Параметр может принимать следующие значения.
- WH_CALLWNDPROC - Устанавливает hook процедуру, которая отслеживает сообщения до того, как система перешлёт их в обработку окну назначения.
- WH_CALLWNDPROCRET - Устанавливает hook процедуру, которая отслеживает сообщения после того, как они были обработаны окном назначения.
- WH_CBT - Устанавливает hook процедуру, которая принимает полезные уведомления для прикладной программы.
- WH_DEBUG - устанавливает hook процедуру, которая полезна при отладке других hook процедур.
- WH_FOREGROUNDIDLE - Устанавливает hook процедуру, которая будет вызываться в том случае, когда приложение простаивает. Может быть полезно для выполнения задач с низким приоритетом во время простоя.
- WH_GETMESSAGE - устанавливает hook процедуру, которая контролирует сообщения, отправленные в очередь сообщений.
- WH_JOURNALPLAYBACK - устанавливает hook процедуру, вызывающую сообщения, ранее записанные с помощью процедуры WH_JOURNALRECORD.
- WH_JOURNALRECORD - устанавливает hook процедуру, которая записывает входные сообщения, отправленные в системную очередь сообщений. Данный hook полезен для записи макросов.
- WH_KEYBOARD - устанавливает hook процедуру, которая отслеживает нажатия клавиш.
- WH_KEYBOARD_LL - устанавливает hook процедуру, которая контролирует события клавиатуры на низком уровне.
- WH_MOUSE - устанавливает hook процедуру, которая отслеживает события мыши.
- WH_MOUSE_LL - устанавливает hook процедуру, которая отслеживает события мыши на низком уровне.
- WH_MSGFILTER - устанавливает hook процедуру, которая контролирует сообщения, сгенерированные в результате события ввода в диалоговом окне, окне сообщений, меню или полосы прокрутки.
- WH_SHELL - устанавливает hook процедуру, которая получает уведомления, полезные для приложений оболочки.
- WH_SYSMSGFILTER - устанавливает hook процедуру, которая контролирует сообщения, сгенерированные в результате события ввода в диалоговом окне, окне сообщений, меню или полосы прокрутки. Подключаемая процедура контролирует эти сообщения для всех приложений в том же рабочем столе, что и вызывающий поток.
lpfn [in]
Тип: HOOKPROC
Указатель на hook процедуру. Если dwThreadId параметр равен нулю или определяет идентификатор треда, созданного другим процессом, параметр lpfn должен указывать на подключаемую процедуру в DLL. В противном случае lpfn может указывать на подключаемую процедуру в коде, связанном с текущим процессом.
hMod [in]
Тип: HINSTANCE
Дескриптор библиотеки DLL, содержащей процедуру hook, на который указывает параметр lpfn. Параметр hMod должен быть установлен в NULL, если dwThreadId параметр определяет поток, созданный текущим процессом и если hook процедура находится в пределах кода, связанного с текущим процессом.
dwThreadId [in]
Тип: DWORD
Идентификатор потока, с которым подключаемая процедура должна быть связана. Для настольных приложений, если этот параметр равен нулю, подключаемая процедура связана со всеми существующими потоками, запущенными в том же рабочем столе, что и вызывающий поток. Для приложений Windows Store, в разделе Замечания.
Возвращаемое значение
Тип: *HHOOK *
Если функция завершается успешно, то возвращаемое значение равно обработчику хука. В противном случае будет возвращён NULL. Для большей информации об ошибке вызывайте GetLastError.
Структура проекта
После краткого ознакомления с функцией, которую будем использовать для установки hook, посмотрим на структуру проекта, который продемонстрирует вариант подключения функции к отслеживанию мыши.
- MouseHook.pro - профайл проекта;
- main.cpp - файл с main функцией;
- mouselogger.h - заголовочный файл класса для отслеживания событий мыши в системе;
- mouselogger.cpp - файл исходных кодов для отслеживания событий мыши в системе.
MouseHook.pro
Профайл создаётся по умолчанию.
QT += core
QT -= gui
CONFIG += c++11
TARGET = MouseHook
CONFIG += console
CONFIG -= app_bundle
TEMPLATE = app
SOURCES += main.cpp \
mouselogger.cpp
HEADERS += \
mouselogger.h
main.cpp
В данном файле, чтобы продемонстрировать работу сигналов и слотов, показано подключение лямбда функции к объекту для логирования событий мыши, но применёно подключение к объекту с использованием паттерна "Синглтон".
#include <QCoreApplication>
#include <QDebug>
#include "mouselogger.h"
int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);
QObject::connect(&MouseLogger::instance(), &MouseLogger::mouseEvent,
[](){
qDebug() << "Mouse Event";
});
return a.exec();
}
mouselogger.h
Заголовочный файл класса для логирования сообщений о событиях мыши. В данном файле необходимо объявить статические методы:
- Для возвращения ссылки на объект синглтона, через которую был подключен слот к сигналу о событии мыши.
- Статический метод mouseProc , который будет использоваться для обработки событий.
#ifndef MOUSELOGGER_H
#define MOUSELOGGER_H
#include <QObject>
#include <windows.h>
class MouseLogger : public QObject
{
Q_OBJECT
Q_DISABLE_COPY(MouseLogger)
public:
static MouseLogger &instance();
explicit MouseLogger(QObject *parent = nullptr);
virtual ~MouseLogger(){}
// Статический метод, который будет выступать в качестве
// callback-функции
static LRESULT CALLBACK mouseProc(int Code, WPARAM wParam, LPARAM lParam);
signals:
// Сигнал, который будет сообщать о возникновении события
void mouseEvent();
public slots:
private:
// обработчик хука
HHOOK mouseHook;
};
#endif // MOUSELOGGER_H
mouselogger.cpp
#include "mouselogger.h"
#include <QDebug>
MouseLogger &MouseLogger::instance()
{
static MouseLogger _instance;
return _instance;
}
MouseLogger::MouseLogger(QObject *parent) : QObject(parent)
{
HINSTANCE hInstance = GetModuleHandle(NULL);
// Устанавливаем хук
mouseHook = SetWindowsHookEx(WH_MOUSE_LL, mouseProc, hInstance, 0);
// Проверяем, что установка хука прошла успешно
if (mouseHook == NULL) {
qWarning() << "Mouse Hook failed";
}
}
LRESULT CALLBACK MouseLogger::mouseProc(int Code, WPARAM wParam, LPARAM lParam)
{
Q_UNUSED(Code)
// Получив событие хука, кастуем аргумент lParam
// к структуре именно хука мыши.
MOUSEHOOKSTRUCT * pMouseStruct = (MOUSEHOOKSTRUCT *)lParam;
// Далее проверяем, какое именно событие пришло,
// если структура не является указателем на nullptr
if(pMouseStruct != nullptr) {
switch (wParam) {
case WM_MOUSEMOVE:
qDebug() << "WM_MOUSEMOVE";
break;
case WM_LBUTTONDOWN:
qDebug() << "WM_LBUTTONDOWN";
break;
case WM_LBUTTONUP:
qDebug() << "WM_LBUTTONUP";
break;
case WM_RBUTTONDOWN:
qDebug() << "WM_RBUTTONDOWN";
break;
case WM_RBUTTONUP:
qDebug() << "WM_RBUTTONUP";
break;
case WM_MBUTTONDOWN:
qDebug() << "WM_MBUTTONDOWN";
break;
case WM_MBUTTONUP:
qDebug() << "WM_MBUTTONUP";
break;
case WM_MOUSEWHEEL:
qDebug() << "WM_MOUSEWHEEL";
break;
default:
break;
}
emit instance().mouseEvent();
}
// После чего событие хука необходимо вернуть обратно в цепочку обработчиков
return CallNextHookEx(NULL, Code, wParam, lParam);
}
Итог
В результате получится отслеживать события мыши в независимости от того, находится ли курсор мыши в фокусе программы, если приложение имеет графический интерфейс, или не находится в фокусе программы.
