qxtglobalshortcut/README.md

1.7 KiB

Cross-platform library for handling system-wide shortcuts in Qt applications.

Build Status

API Reference

This code was originally part of Qtx which is no longer maintained.

Supported Platforms

  • Windows (由于环境原因,还没有尝试)
  • OS X (由于采用的技术过时了,已经试过了,不好用)
  • Linux/X11 (试过了,好用的)

Requirements

  • Compiler with C++11 support
  • Qt 6 or Qt 5
  • CMake 3.0.0 and later

Build

To build the library without installation run:

mkdir build
cd build
cmake -S .. -DCMAKE_PREFIX_PATH:PATH=~/Qt/6.9.0/gcc_64
make

To build and install run:

mkdir build
cd build
cmake -S .. -DCMAKE_PREFIX_PATH:PATH=~/Qt/6.9.0/gcc_64 -DCMAKE_INSTALL_PREFIX=/usr/local
make
sudo make install

To build static library run:

mkdir build
cd build
cmake -S .. -DCMAKE_PREFIX_PATH:PATH=~/Qt/6.9.0/gcc_64 -DQXTGLOBALSHORTCUT_STATIC=ON
make

Use the Library

Directory "example" contains simple CMake project which uses the installed library.

To compile and run the example:

mkdir build
cd build
mkdir example
cd example
cmake -S ../../example -DCMAKE_PREFIX_PATH:PATH=~/Qt/6.9.0/gcc_64
make
./qxtglobalshortcut_test 

If cmake prints error that it cannot find package for the library you have to specify it's install path. E.g.

qxtglobalshortcut_DIR=/usr/local/lib/cmake/qxtglobalshortcut cmake .

Alternatively you can add the path to CMAKE_PREFIX_PATH environment variable.