Робота з глобальними хоткеями у Windows є більш тривіальним завданням, ніж у Linux, оскільки у WinAPI є для цього підготовлені методи, які не вимагають великого кількості коду. А також кожному хоткею встановлюється у відповідність ID , яким даний хоткей можна видалити.
У Linux/Unix , які використовують графічний сервер X11, стосовно Qt необхідно використовувати функції для реєстрації/розреєстрації хоткеїв з бібліотеки XLib, але обробляти доводиться одержувані значення за допомогою функціоналу бібліотеки XCB,* * яка розробляється як аналог бібліотеки XLib , але є більш низькорівневою та написана мовою програмування Сі. Як і у випадку з Windows, для обробки глобальних хоткеїв у Qt 5.5 використовується метод nativeEventFilter. Пропоную зробити окремий клас, успадкований від QAbstractNativeEventFilter для обробки хоткеїв та встановити цей фільтр на весь додаток.
Для встановлення хоткеїв будуть використовуватися функції XKeysymToKeycode (для отримання коду клавіші з послідовності KeySym) та XGrabKey (для встановлення хоткею).
Для розреєстрації хоткея використовуватиметься функція XUngrabKey .
Структура проекта
- GlobalHotkeyLinux.pro - профайл проекту;
- mainwindow.h - заголовний файл головного вікна програми;
- mainwindow.cpp - файл вихідних кодів головного вікна програми;
- mainwindow.ui - файл форми головного вікна програми;
- main.cpp - основний файл вихідних кодів;
- nativeeventfilter.h - заголовний файл фільтра подій хоткеїв;
- nativeeventfilter.cpp - файл вихідних кодів фільтра подій хоткеїв.
GlobalHotkeyLinux.pro
Звертаю Вашу увагу на те, що для отримання інформації про події від віконного сервера X11 в Qt використовується клас QX11Info , а для його використання необхідно підключити модуль x11extras, але і цього може бути недостатньо, оскільки у стандартній поставці Qt5.5 цих бібліотек просто не буде, тому їх потрібно буде встановити наступною командою:
sudo apt-get install qtx11extras5-dev-tools
Крім цього для роботи з бібліотеками xcb і xlib необхідно буде вказати конфігурацію проекту з урахуванням X11:
CONFIG += link_pkgconfig PKGCONFIG += x11
Після чого отримаємо профайл із наступним змістом.
#-------------------------------------------------
#
# Project created by QtCreator 2016-02-12T23:41:57
#
#-------------------------------------------------
QT += core gui
QT += x11extras
greaterThan(QT_MAJOR_VERSION, 4): QT += widgets
CONFIG += c++11
CONFIG += link_pkgconfig
PKGCONFIG += x11
TARGET = GlobalHotkeyLinux
TEMPLATE = app
SOURCES += main.cpp\
mainwindow.cpp \
nativeeventfilter.cpp
HEADERS += mainwindow.h \
nativeeventfilter.h
FORMS += mainwindow.ui
nativeeventfilter.h
У Qt існують класи фільтрів подій, які можна встановлювати на вікна програми, компоненти або відразу на всю програму, як Ми і надійдемо цього разу. Для цього потрібно створити клас, успадкований від QAbstractNativeEventFilter, який служить для отримання подій від операційної системи, в якій запускається додаток на Qt. Перевизначимо метод natvieEventFilter, в якому і будемо обробляти хоткей, а також зробимо два методи: один для встановлення хоткею, а другий для його відключення.
#ifndef NATIVEEVENTFILTER_H
#define NATIVEEVENTFILTER_H
#include <QObject>
#include <QAbstractNativeEventFilter>
class NativeEventFilter : public QObject, public QAbstractNativeEventFilter
{
Q_OBJECT
public:
explicit NativeEventFilter(QObject *parent = 0);
// переопределяем метод nativeEventFilter
bool nativeEventFilter(const QByteArray &eventType, void *message, long *result);
void setShortcut(); // Добавляем метод установки хоткея
void unsetShortcut(); // и метод удаления хоткея для полноты картины
signals:
void activated();
public slots:
};
#endif // NATIVEEVENTFILTER_H
nativeeventfilter.cpp
Вся сіль створення фільтра в тому, що ми без проблем можемо зареєструвати хоткей, використовуючи бібліотеку XLib, тоді як розбирати події доведеться із застосуванням бібліотеки XCB, оскільки Qt, отримуючи дані від X11, не має про них у розрізі Xlib, а розуміє ці дані як XCB.
#include "nativeeventfilter.h"
#include <QVector>
#include <QX11Info>
#include <X11/Xlib.h>
#include <X11/Xutil.h>
#include <xcb/xcb.h>
namespace
{
Display * m_display; // Соединение с сервером X11
Window m_win; // Захватываемое окно - в данном случае будет вся система
int keycode; // код клавиши
unsigned int modifier; // код модификаторов
/* Вектор дополнительных модификаторов Num Lock, Caps lock
* Они тоже учитываются в X11, поэтому понадобяться все возможные комбинации
* */
QVector<quint32> maskModifiers(){
return QVector<quint32>() << 0 << Mod2Mask << LockMask << (Mod2Mask | LockMask);
}
}
NativeEventFilter::NativeEventFilter(QObject *parent) : QObject(parent)
{
m_display = QX11Info::display(); // Создадим подключение к серверу
m_win = DefaultRootWindow(m_display); // и вытащим из него захватываемое окно с помощью макроса
}
bool NativeEventFilter::nativeEventFilter(const QByteArray &eventType, void *message, long *result)
{
Q_UNUSED(eventType)
Q_UNUSED(result)
/* В вот обработка события строится уже на библиотеке XCB вместо Xlib.
* Вроде как, получая событие Qt знает его в качестве XCB события,
* но не знает его в качестве события Xlib, хотя использовать более
* легкий синтаксис Xlib для установки хоткеев нам никто не запрещает
* */
xcb_key_press_event_t *keyEvent = 0;
// Итак проверяем, что это было xcb событие
if (eventType == "xcb_generic_event_t") {
// кастуем сообщение собственно в xcb событие
xcb_generic_event_t *event = static_cast<xcb_generic_event_t *>(message);
// проверяем, что произошло нажатие клавиши
if ((event->response_type & 127) == XCB_KEY_PRESS){
// Если так, то кастуем сообщение в событие нажатия клавиши
keyEvent = static_cast<xcb_key_press_event_t *>(message);
// Далее проверям, является ли это событие нужным хоткее
foreach (quint32 maskMods, maskModifiers()) {
if((keyEvent->state == (modifier | maskMods ))
&& keyEvent->detail == keycode){
emit activated(); // и посылаем сигнал
return true;
}
}
}
}
return false;
}
void NativeEventFilter::setShortcut()
{
unsetShortcut(); /* Вначале для перестраховки отключим предполагаемый хоткей,
* даже несмотря на то, что будет мусор в первый раз в параметрах хоткея.
* */
// получим код клавиши из KeySym определения и соединения с сервером X11
keycode = XKeysymToKeycode(m_display, XK_E);
modifier = ControlMask; // Зададим модификатор
/* А теперь пройдемся по всем возможным комбинациям с учётом Num Lock и Caps Lock
* устанавливая хоткеи
* */
foreach (quint32 maskMods, maskModifiers()) {
XGrabKey(m_display, // указываем соединение с X11
keycode , // код клавиши
modifier | maskMods, // модификатор со всеми возможными масками
m_win, // Захватываемое окно
True, // Является ли приложение владельцем события. в данном примере не принципиально.
GrabModeAsync, // Обязательно Ассинхронный режим обработки, иначе, рискуете встрять
GrabModeAsync); // с замороженной системой, не реагирующей ни на какие воздействия, если
// заранее не напишите корректную передачу события обратно в систему,
// а скорее всего так и будет
}
}
void NativeEventFilter::unsetShortcut()
{
// Проходим по всем возможным комбинациям и удаляем хоткей
foreach (quint32 maskMods, maskModifiers()) {
XUngrabKey(m_display,
keycode,
modifier | maskMods,
m_win);
}
}
mainwindow.h
У заголовному файлі програми нічого особливого не бачимо. Тільки слот для прийому сигналу та сам фільтр, який віддаватиме цей сигнал.
#ifndef MAINWINDOW_H
#define MAINWINDOW_H
#include <QMainWindow>
#include "nativeeventfilter.h"
namespace Ui {
class MainWindow;
}
class MainWindow : public QMainWindow
{
Q_OBJECT
public:
explicit MainWindow(QWidget *parent = 0);
~MainWindow();
private slots:
void slotGlobalHotkey();
private:
Ui::MainWindow *ui;
NativeEventFilter *nativeEventFilter;
};
#endif // MAINWINDOW_H
mainwindow.cpp
Все, що залишиться зробити, це ініціалізувати фільтр, встановити його на всю програму, підключити сигнал до слота обробнику події та встановити хоткей. Таким чином, отримаємо робочий варіант глобального хоткею для Qt програми для linux.
#include "mainwindow.h"
#include "ui_mainwindow.h"
#include <QApplication>
#include <QMessageBox>
MainWindow::MainWindow(QWidget *parent) :
QMainWindow(parent),
ui(new Ui::MainWindow)
{
ui->setupUi(this);
nativeEventFilter = new NativeEventFilter(this); // Инициализируем фильтр
qApp->installNativeEventFilter(nativeEventFilter); // Устанавилваем его на приложение
// подключаем сигнал фильтра к слоту
connect(nativeEventFilter, &NativeEventFilter::activated, this, &MainWindow::slotGlobalHotkey);
nativeEventFilter->setShortcut(); // Устанавилваем хоткей
}
MainWindow::~MainWindow()
{
delete ui;
}
void MainWindow::slotGlobalHotkey()
{
// И сообщаем пользователю, если он нажал нужный нам HotKey
QMessageBox::information(this,"Global Hotkey", "Global Hotkey is worked", QMessageBox::Ok);
}
Архів з проектом: GlobalHotkeyLinux
Підсумок
В результаті отримаємо програму, яка буде реагувати на глобальний хоткей Ctrl+E і показувати повідомлення про те, що хоткей працює, навіть якщо Ви повернете програму або працюватимете з іншим додатком. Тільки не намагайтеся захопити натискання клавіші PrintScreen . Це не спрацює швидше за все. Причина в тому, що коли за допомогою XGrabKey спробувати захопити якийсь хоткей, то він буде захоплений тільки в тому випадку, якщо будь-яка інша клієнтська програма ще не захопило цей хоткей на цільовому вікні. А якщо врахувати, що в тому самому дистрибутиві Ubuntu вже є додаток для створення скріншотів, який якраз і реагує на клавішу PrintScreen, то Ви зі 100% ймовірністю не зможете перехопити цю клавішу, доки не вб'єте цю програму або яким -або іншим способом не змусите її відпустити цей хоткей.
