2017-03-30 02:03:43 +08:00
# Qt5 module
2017-08-21 05:22:33 +08:00
The Qt5 module provides tools to automatically deal with the various
2017-11-23 08:42:49 +08:00
tools and steps required for Qt. The module has two methods.
2017-03-30 02:03:43 +08:00
## preprocess
2017-10-27 14:38:15 +08:00
This method takes the following keyword arguments:
- `moc_headers` , `moc_sources` , `ui_files` , `qresources` , which define the files that require preprocessing with `moc` , `uic` and `rcc`
- `include_directories` , the directories to add to header search path for `moc` (optional)
2017-10-27 14:43:26 +08:00
- `moc_extra_arguments` , any additional arguments to `moc` (optional). Available since v0.44.0.
2017-10-27 14:38:15 +08:00
It returns an opaque object that should be passed to a main build target.
2017-11-24 04:20:45 +08:00
## compile_translations (since v0.44.0)
2017-11-23 08:42:49 +08:00
This method generates the necessary targets to build translation files with lrelease, it takes the following keyword arguments:
- `ts_files` , the list of input translation files produced by Qt's lupdate tool.
2017-11-24 04:20:45 +08:00
- `install` when true, this target is installed during the install step (optional).
- `install_dir` directory to install to (optional).
- `build_by_default` when set to true, to have this target be built by default, that is, when invoking plain ninja; the default value is false (optional).
2017-11-23 08:42:49 +08:00
2017-10-24 16:05:26 +08:00
A simple example would look like this:
2017-03-30 02:03:43 +08:00
```meson
qt5 = import('qt5')
2017-06-23 05:17:21 +08:00
qt5_dep = dependency('qt5', modules: ['Core', 'Gui'])
2017-10-01 22:18:31 +08:00
inc = include_directories('includes')
2017-10-27 14:46:25 +08:00
moc_files = qt5.preprocess(moc_headers : 'myclass.h',
moc_extra_arguments: ['-DMAKES_MY_MOC_HEADER_COMPILE'],
include_directories: inc)
2017-11-23 08:42:49 +08:00
translations = qt5.compile_translations(ts_files : 'myTranslation_fr.ts', build_by_default : true)
2017-03-30 02:03:43 +08:00
executable('myprog', 'main.cpp', 'myclass.cpp', moc_files,
2017-10-01 22:18:31 +08:00
include_directories: inc,
2017-03-30 02:03:43 +08:00
dependencies : qt5_dep)
```
2017-06-23 05:17:21 +08:00
2017-08-21 05:22:33 +08:00
The 'modules' argument is used to include Qt modules in the project.
2017-11-23 08:42:49 +08:00
See the Qt documentation for the [list of modules ](http://doc.qt.io/qt-5/qtmodules.html ).