1AUTORCC 2------- 3 4Should the target be processed with auto-rcc (for Qt projects). 5 6:prop_tgt:`AUTORCC` is a boolean specifying whether CMake will handle 7the Qt ``rcc`` code generator automatically, i.e. without having to use 8commands like :module:`QT4_ADD_RESOURCES() <FindQt4>`, ``QT5_ADD_RESOURCES()``, 9etc. Currently, Qt versions 4 to 6 are supported. 10 11When this property is ``ON``, CMake will handle ``.qrc`` files added 12as target sources at build time and invoke ``rcc`` accordingly. 13This property is initialized by the value of the :variable:`CMAKE_AUTORCC` 14variable if it is set when a target is created. 15 16By default :prop_tgt:`AUTORCC` is processed by a 17:command:`custom command <add_custom_command>`. 18If the ``.qrc`` file is :prop_sf:`GENERATED`, a 19:command:`custom target <add_custom_target>` is used instead. 20 21When there are multiple ``.qrc`` files with the same name, CMake will 22generate unspecified unique output file names for ``rcc``. Therefore, if 23``Q_INIT_RESOURCE()`` or ``Q_CLEANUP_RESOURCE()`` need to be used, the 24``.qrc`` file name must be unique. 25 26 27Modifiers 28^^^^^^^^^ 29 30:prop_tgt:`AUTORCC_EXECUTABLE`: 31The ``rcc`` executable will be detected automatically, but can be forced to 32a certain binary by setting this target property. 33 34:prop_tgt:`AUTORCC_OPTIONS`: 35Additional command line options for ``rcc`` can be set via this target 36property. The corresponding :prop_sf:`AUTORCC_OPTIONS` source file property 37can be used to specify options to be applied only to a specific ``.qrc`` file. 38 39:prop_sf:`SKIP_AUTORCC`: 40``.qrc`` files can be excluded from :prop_tgt:`AUTORCC` processing by 41setting this source file property. 42 43:prop_sf:`SKIP_AUTOGEN`: 44Source files can be excluded from :prop_tgt:`AUTOMOC`, 45:prop_tgt:`AUTOUIC` and :prop_tgt:`AUTORCC` processing by 46setting this source file property. 47 48:prop_gbl:`AUTOGEN_SOURCE_GROUP`: 49This global property can be used to group files generated by 50:prop_tgt:`AUTOMOC` or :prop_tgt:`AUTORCC` together in an IDE, e.g. in MSVS. 51 52:prop_gbl:`AUTOGEN_TARGETS_FOLDER`: 53This global property can be used to group :prop_tgt:`AUTOMOC`, 54:prop_tgt:`AUTOUIC` and :prop_tgt:`AUTORCC` targets together in an IDE, 55e.g. in MSVS. 56 57:variable:`CMAKE_GLOBAL_AUTORCC_TARGET`: 58A global ``autorcc`` target that depends on all :prop_tgt:`AUTORCC` targets 59in the project will be generated when this variable is ``ON``. 60 61See the :manual:`cmake-qt(7)` manual for more information on using CMake 62with Qt. 63