OXIESEC PANEL

Name	Size	Modified	Perms
📁 ..	-	04/04/2023 07:10:48 PM	rwxr-xr-x
📄 ccmake.1.html	44.19 KB	04/04/2023 07:05:08 PM	rw-r--r--
📄 cmake-buildsystem.7.html	161.14 KB	04/04/2023 07:05:09 PM	rw-r--r--
📄 cmake-commands.7.html	21.66 KB	04/04/2023 07:05:09 PM	rw-r--r--
📄 cmake-compile-features.7.html	46.17 KB	04/04/2023 07:05:09 PM	rw-r--r--
📄 cmake-configure-log.7.html	35.93 KB	04/04/2023 07:05:09 PM	rw-r--r--
📄 cmake-developer.7.html	60.56 KB	04/04/2023 07:05:09 PM	rw-r--r--
📄 cmake-env-variables.7.html	15.36 KB	04/04/2023 07:05:09 PM	rw-r--r--
📄 cmake-file-api.7.html	174.79 KB	04/04/2023 07:05:10 PM	rw-r--r--
📄 cmake-generator-expressions.7.html	229.68 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-generators.7.html	16.07 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-gui.1.html	27.62 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-language.7.html	67.9 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-modules.7.html	37.63 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-packages.7.html	84.94 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-policies.7.html	48.41 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-presets.7.html	122.21 KB	04/04/2023 07:05:12 PM	rw-r--r--
📄 cmake-properties.7.html	80.47 KB	04/04/2023 07:05:12 PM	rw-r--r--
📄 cmake-qt.7.html	47.92 KB	04/04/2023 07:05:12 PM	rw-r--r--
📄 cmake-server.7.html	5.39 KB	04/04/2023 07:05:12 PM	rw-r--r--
📄 cmake-toolchains.7.html	92.74 KB	04/04/2023 07:05:12 PM	rw-r--r--
📄 cmake-variables.7.html	105.71 KB	04/04/2023 07:05:12 PM	rw-r--r--
📄 cmake.1.html	170.8 KB	04/04/2023 07:05:13 PM	rw-r--r--
📄 cpack-generators.7.html	7.54 KB	04/04/2023 07:05:13 PM	rw-r--r--
📄 cpack.1.html	39.49 KB	04/04/2023 07:05:13 PM	rw-r--r--
📄 ctest.1.html	230.72 KB	04/04/2023 07:05:13 PM	rw-r--r--

Editing: cmake-qt.7.html

<!DOCTYPE html>

<title>cmake-qt(7) &mdash; CMake 3.26.3 Documentation</title>

</head><body>

<div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="../genindex.html" title="General Index"
 accesskey="I">index</a></li>
 <li class="right" >
 <a href="cmake-server.7.html" title="cmake-server(7)"
 accesskey="N">next</a> |</li>
 <li class="right" >
 <a href="../prop_sf/COMPILE_DEFINITIONS_CONFIG.html" title="COMPILE_DEFINITIONS_&lt;CONFIG&gt;"
 accesskey="P">previous</a> |</li>
 <li>
 <img src="../_static/cmake-logo-16.png" alt=""
 style="vertical-align: middle; margin-top: -2px" />
 </li>
 <li>
 <a href="https://cmake.org/">CMake</a> &#187;
 </li>
 <li>
 <a href="../index.html">3.26.3 Documentation</a> &#187;
 </li>

<li class="nav-item nav-item-this"><a href="">cmake-qt(7)</a></li> 
 </ul>
 </div>

<div class="document">
 <div class="documentwrapper">
 <div class="bodywrapper">
 <div class="body" role="main">
 
 <section id="cmake-qt-7">
<h1><a class="toc-backref" href="#id1" role="doc-backlink">cmake-qt(7)</a><a class="headerlink" href="#cmake-qt-7" title="Permalink to this heading">¶</a></h1>
<nav class="contents" id="contents">
Contents
<ul class="simple">
<li><a class="reference internal" href="#cmake-qt-7" id="id1">cmake-qt(7)</a>
<ul>
<li><a class="reference internal" href="#introduction" id="id2">Introduction</a></li>
<li><a class="reference internal" href="#qt-build-tools" id="id3">Qt Build Tools</a>
<ul>
<li><a class="reference internal" href="#automoc" id="id4">AUTOMOC</a></li>
<li><a class="reference internal" href="#autouic" id="id5">AUTOUIC</a></li>
<li><a class="reference internal" href="#autorcc" id="id6">AUTORCC</a></li>
</ul>
</li>
<li><a class="reference internal" href="#the-origin-autogen-target" id="id7">The <code class="docutils literal notranslate">&lt;ORIGIN&gt;_autogen</code> target</a></li>
<li><a class="reference internal" href="#visual-studio-generators" id="id8">Visual Studio Generators</a></li>
<li><a class="reference internal" href="#qtmain-lib-on-windows" id="id9">qtmain.lib on Windows</a></li>
</ul>
</li>
</ul>
</nav>
<section id="introduction">
<h2><a class="toc-backref" href="#id2" role="doc-backlink">Introduction</a><a class="headerlink" href="#introduction" title="Permalink to this heading">¶</a></h2>
CMake can find and use Qt 4 and Qt 5 libraries. The Qt 4 libraries are found
by the <a class="reference internal" href="../module/FindQt4.html#module:FindQt4" title="FindQt4"><code class="xref cmake cmake-module docutils literal notranslate">FindQt4</code></a> find-module shipped with CMake, whereas the
Qt 5 libraries are found using &quot;Config-file Packages&quot; shipped with Qt 5. See
<a class="reference internal" href="cmake-packages.7.html#manual:cmake-packages(7)" title="cmake-packages(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-packages(7)</code></a> for more information about CMake packages, and
see <a class="reference external" href="https://contribute.qt-project.org/doc/qt-5/cmake-manual.html">the Qt cmake manual</a>
for your Qt version.
Qt 4 and Qt 5 may be used together in the same
<a class="reference internal" href="cmake-buildsystem.7.html#manual:cmake-buildsystem(7)" title="cmake-buildsystem(7)"><code class="xref cmake cmake-manual docutils literal notranslate">CMake buildsystem</code></a>:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>cmake_minimum_required(VERSION 3.8.0 FATAL_ERROR)

project(Qt4And5)

set(CMAKE_AUTOMOC ON)

find_package(Qt5 COMPONENTS Widgets DBus REQUIRED)
add_executable(publisher publisher.cpp)
target_link_libraries(publisher Qt5::Widgets Qt5::DBus)

find_package(Qt4 REQUIRED)
add_executable(subscriber subscriber.cpp)
target_link_libraries(subscriber Qt4::QtGui Qt4::QtDBus)
</pre></div>
</div>
A CMake target may not link to both Qt 4 and Qt 5. A diagnostic is issued if
this is attempted or results from transitive target dependency evaluation.
</section>
<section id="qt-build-tools">
<h2><a class="toc-backref" href="#id3" role="doc-backlink">Qt Build Tools</a><a class="headerlink" href="#qt-build-tools" title="Permalink to this heading">¶</a></h2>
Qt relies on some bundled tools for code generation, such as <code class="docutils literal notranslate">moc</code> for
meta-object code generation, <code class="docutils literal notranslate">uic</code> for widget layout and population,
and <code class="docutils literal notranslate">rcc</code> for virtual file system content generation. These tools may be
automatically invoked by <a class="reference internal" href="cmake.1.html#manual:cmake(1)" title="cmake(1)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake(1)</code></a> if the appropriate conditions
are met. The automatic tool invocation may be used with both Qt 4 and Qt 5.
<section id="automoc">
<h3><a class="toc-backref" href="#id4" role="doc-backlink">AUTOMOC</a><a class="headerlink" href="#automoc" title="Permalink to this heading">¶</a></h3>
The <a class="reference internal" href="../prop_tgt/AUTOMOC.html#prop_tgt:AUTOMOC" title="AUTOMOC"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOMOC</code></a> target property controls whether <a class="reference internal" href="cmake.1.html#manual:cmake(1)" title="cmake(1)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake(1)</code></a>
inspects the C++ files in the target to determine if they require <code class="docutils literal notranslate">moc</code> to
be run, and to create rules to execute <code class="docutils literal notranslate">moc</code> at the appropriate time.
If a macro from <a class="reference internal" href="../prop_tgt/AUTOMOC_MACRO_NAMES.html#prop_tgt:AUTOMOC_MACRO_NAMES" title="AUTOMOC_MACRO_NAMES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOMOC_MACRO_NAMES</code></a> is found in a header file,
<code class="docutils literal notranslate">moc</code> will be run on the file. The result will be put into a file named
according to <code class="docutils literal notranslate">moc_&lt;basename&gt;.cpp</code>.
If the macro is found in a C++ implementation
file, the moc output will be put into a file named according to
<code class="docutils literal notranslate">&lt;basename&gt;.moc</code>, following the Qt conventions. The <code class="docutils literal notranslate">&lt;basename&gt;.moc</code> must
be included by the user in the C++ implementation file with a preprocessor
<code class="docutils literal notranslate">#include</code>.
Included <code class="docutils literal notranslate">moc_*.cpp</code> and <code class="docutils literal notranslate">*.moc</code> files will be generated in the
<code class="docutils literal notranslate">&lt;AUTOGEN_BUILD_DIR&gt;/include</code> directory which is
automatically added to the target's <a class="reference internal" href="../prop_tgt/INCLUDE_DIRECTORIES.html#prop_tgt:INCLUDE_DIRECTORIES" title="INCLUDE_DIRECTORIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INCLUDE_DIRECTORIES</code></a>.
<ul class="simple">
<li>This differs from CMake 3.7 and below; see their documentation for details.</li>
<li>For <a class="reference internal" href="../prop_gbl/GENERATOR_IS_MULTI_CONFIG.html#prop_gbl:GENERATOR_IS_MULTI_CONFIG" title="GENERATOR_IS_MULTI_CONFIG"><code class="xref cmake cmake-prop_gbl docutils literal notranslate">multi configuration generators</code></a>,
the include directory is <code class="docutils literal notranslate">&lt;AUTOGEN_BUILD_DIR&gt;/include_&lt;CONFIG&gt;</code>.</li>
<li>See <a class="reference internal" href="../prop_tgt/AUTOGEN_BUILD_DIR.html#prop_tgt:AUTOGEN_BUILD_DIR" title="AUTOGEN_BUILD_DIR"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOGEN_BUILD_DIR</code></a>.</li>
</ul>
Not included <code class="docutils literal notranslate">moc_&lt;basename&gt;.cpp</code> files will be generated in custom
folders to avoid name collisions and included in a separate
file which is compiled into the target, named either
<code class="docutils literal notranslate">&lt;AUTOGEN_BUILD_DIR&gt;/mocs_compilation.cpp</code> or
<code class="docutils literal notranslate">&lt;AUTOGEN_BUILD_DIR&gt;/mocs_compilation_$&lt;CONFIG&gt;.cpp</code>.
<ul class="simple">
<li>See <a class="reference internal" href="../prop_tgt/AUTOGEN_BUILD_DIR.html#prop_tgt:AUTOGEN_BUILD_DIR" title="AUTOGEN_BUILD_DIR"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOGEN_BUILD_DIR</code></a>.</li>
</ul>
The <code class="docutils literal notranslate">moc</code> command line will consume the <a class="reference internal" href="../prop_tgt/COMPILE_DEFINITIONS.html#prop_tgt:COMPILE_DEFINITIONS" title="COMPILE_DEFINITIONS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">COMPILE_DEFINITIONS</code></a> and
<a class="reference internal" href="../prop_tgt/INCLUDE_DIRECTORIES.html#prop_tgt:INCLUDE_DIRECTORIES" title="INCLUDE_DIRECTORIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INCLUDE_DIRECTORIES</code></a> target properties from the target it is being
invoked for, and for the appropriate build configuration.
The <a class="reference internal" href="../prop_tgt/AUTOMOC.html#prop_tgt:AUTOMOC" title="AUTOMOC"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOMOC</code></a> target property may be pre-set for all
following targets by setting the <a class="reference internal" href="../variable/CMAKE_AUTOMOC.html#variable:CMAKE_AUTOMOC" title="CMAKE_AUTOMOC"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_AUTOMOC</code></a> variable. The
<a class="reference internal" href="../prop_tgt/AUTOMOC_MOC_OPTIONS.html#prop_tgt:AUTOMOC_MOC_OPTIONS" title="AUTOMOC_MOC_OPTIONS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOMOC_MOC_OPTIONS</code></a> target property may be populated to set
options to pass to <code class="docutils literal notranslate">moc</code>. The <a class="reference internal" href="../variable/CMAKE_AUTOMOC_MOC_OPTIONS.html#variable:CMAKE_AUTOMOC_MOC_OPTIONS" title="CMAKE_AUTOMOC_MOC_OPTIONS"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_AUTOMOC_MOC_OPTIONS</code></a>
variable may be populated to pre-set the options for all following targets.
Additional macro names to search for can be added to
<a class="reference internal" href="../prop_tgt/AUTOMOC_MACRO_NAMES.html#prop_tgt:AUTOMOC_MACRO_NAMES" title="AUTOMOC_MACRO_NAMES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOMOC_MACRO_NAMES</code></a>.
Additional <code class="docutils literal notranslate">moc</code> dependency file names can be extracted from source code
by using <a class="reference internal" href="../prop_tgt/AUTOMOC_DEPEND_FILTERS.html#prop_tgt:AUTOMOC_DEPEND_FILTERS" title="AUTOMOC_DEPEND_FILTERS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOMOC_DEPEND_FILTERS</code></a>.
Source C++ files can be excluded from <a class="reference internal" href="../prop_tgt/AUTOMOC.html#prop_tgt:AUTOMOC" title="AUTOMOC"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOMOC</code></a> processing by
enabling <a class="reference internal" href="../prop_sf/SKIP_AUTOMOC.html#prop_sf:SKIP_AUTOMOC" title="SKIP_AUTOMOC"><code class="xref cmake cmake-prop_sf docutils literal notranslate">SKIP_AUTOMOC</code></a> or the broader <a class="reference internal" href="../prop_sf/SKIP_AUTOGEN.html#prop_sf:SKIP_AUTOGEN" title="SKIP_AUTOGEN"><code class="xref cmake cmake-prop_sf docutils literal notranslate">SKIP_AUTOGEN</code></a>.
</section>
<section id="autouic">
<h3><a class="toc-backref" href="#id5" role="doc-backlink">AUTOUIC</a><a class="headerlink" href="#autouic" title="Permalink to this heading">¶</a></h3>
The <a class="reference internal" href="../prop_tgt/AUTOUIC.html#prop_tgt:AUTOUIC" title="AUTOUIC"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOUIC</code></a> target property controls whether <a class="reference internal" href="cmake.1.html#manual:cmake(1)" title="cmake(1)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake(1)</code></a>
inspects the C++ files in the target to determine if they require <code class="docutils literal notranslate">uic</code> to
be run, and to create rules to execute <code class="docutils literal notranslate">uic</code> at the appropriate time.
If a preprocessor <code class="docutils literal notranslate">#include</code> directive is found which matches
<code class="docutils literal notranslate">&lt;path&gt;ui_&lt;basename&gt;.h</code>, and a <code class="docutils literal notranslate">&lt;basename&gt;.ui</code> file exists,
then <code class="docutils literal notranslate">uic</code> will be executed to generate the appropriate file.
The <code class="docutils literal notranslate">&lt;basename&gt;.ui</code> file is searched for in the following places
<ol class="arabic simple">
<li><code class="docutils literal notranslate">&lt;source_dir&gt;/&lt;basename&gt;.ui</code></li>
<li><code class="docutils literal notranslate">&lt;source_dir&gt;/&lt;path&gt;&lt;basename&gt;.ui</code></li>
<li><code class="docutils literal notranslate">&lt;AUTOUIC_SEARCH_PATHS&gt;/&lt;basename&gt;.ui</code></li>
<li><code class="docutils literal notranslate">&lt;AUTOUIC_SEARCH_PATHS&gt;/&lt;path&gt;&lt;basename&gt;.ui</code></li>
</ol>
where <code class="docutils literal notranslate">&lt;source_dir&gt;</code> is the directory of the C++ file and
<a class="reference internal" href="../prop_tgt/AUTOUIC_SEARCH_PATHS.html#prop_tgt:AUTOUIC_SEARCH_PATHS" title="AUTOUIC_SEARCH_PATHS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOUIC_SEARCH_PATHS</code></a> is a list of additional search paths.
The generated generated <code class="docutils literal notranslate">ui_*.h</code> files are placed in the
<code class="docutils literal notranslate">&lt;AUTOGEN_BUILD_DIR&gt;/include</code> directory which is
automatically added to the target's <a class="reference internal" href="../prop_tgt/INCLUDE_DIRECTORIES.html#prop_tgt:INCLUDE_DIRECTORIES" title="INCLUDE_DIRECTORIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INCLUDE_DIRECTORIES</code></a>.
<ul class="simple">
<li>This differs from CMake 3.7 and below; see their documentation for details.</li>
<li>For <a class="reference internal" href="../prop_gbl/GENERATOR_IS_MULTI_CONFIG.html#prop_gbl:GENERATOR_IS_MULTI_CONFIG" title="GENERATOR_IS_MULTI_CONFIG"><code class="xref cmake cmake-prop_gbl docutils literal notranslate">multi configuration generators</code></a>,
the include directory is <code class="docutils literal notranslate">&lt;AUTOGEN_BUILD_DIR&gt;/include_&lt;CONFIG&gt;</code>.</li>
<li>See <a class="reference internal" href="../prop_tgt/AUTOGEN_BUILD_DIR.html#prop_tgt:AUTOGEN_BUILD_DIR" title="AUTOGEN_BUILD_DIR"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOGEN_BUILD_DIR</code></a>.</li>
</ul>
The <a class="reference internal" href="../prop_tgt/AUTOUIC.html#prop_tgt:AUTOUIC" title="AUTOUIC"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOUIC</code></a> target property may be pre-set for all following
targets by setting the <a class="reference internal" href="../variable/CMAKE_AUTOUIC.html#variable:CMAKE_AUTOUIC" title="CMAKE_AUTOUIC"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_AUTOUIC</code></a> variable. The
<a class="reference internal" href="../prop_tgt/AUTOUIC_OPTIONS.html#prop_tgt:AUTOUIC_OPTIONS" title="AUTOUIC_OPTIONS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOUIC_OPTIONS</code></a> target property may be populated to set options
to pass to <code class="docutils literal notranslate">uic</code>. The <a class="reference internal" href="../variable/CMAKE_AUTOUIC_OPTIONS.html#variable:CMAKE_AUTOUIC_OPTIONS" title="CMAKE_AUTOUIC_OPTIONS"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_AUTOUIC_OPTIONS</code></a> variable may be
populated to pre-set the options for all following targets. The
<a class="reference internal" href="../prop_sf/AUTOUIC_OPTIONS.html#prop_sf:AUTOUIC_OPTIONS" title="AUTOUIC_OPTIONS"><code class="xref cmake cmake-prop_sf docutils literal notranslate">AUTOUIC_OPTIONS</code></a> source file property may be set on the
<code class="docutils literal notranslate">&lt;basename&gt;.ui</code> file to set particular options for the file. This
overrides options from the <a class="reference internal" href="../prop_tgt/AUTOUIC_OPTIONS.html#prop_tgt:AUTOUIC_OPTIONS" title="AUTOUIC_OPTIONS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOUIC_OPTIONS</code></a> target property.
A target may populate the <a class="reference internal" href="../prop_tgt/INTERFACE_AUTOUIC_OPTIONS.html#prop_tgt:INTERFACE_AUTOUIC_OPTIONS" title="INTERFACE_AUTOUIC_OPTIONS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INTERFACE_AUTOUIC_OPTIONS</code></a> target
property with options that should be used when invoking <code class="docutils literal notranslate">uic</code>. This must be
consistent with the <a class="reference internal" href="../prop_tgt/AUTOUIC_OPTIONS.html#prop_tgt:AUTOUIC_OPTIONS" title="AUTOUIC_OPTIONS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOUIC_OPTIONS</code></a> target property content of the
depender target. The <a class="reference internal" href="../variable/CMAKE_DEBUG_TARGET_PROPERTIES.html#variable:CMAKE_DEBUG_TARGET_PROPERTIES" title="CMAKE_DEBUG_TARGET_PROPERTIES"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_DEBUG_TARGET_PROPERTIES</code></a> variable may
be used to track the origin target of such
<a class="reference internal" href="../prop_tgt/INTERFACE_AUTOUIC_OPTIONS.html#prop_tgt:INTERFACE_AUTOUIC_OPTIONS" title="INTERFACE_AUTOUIC_OPTIONS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INTERFACE_AUTOUIC_OPTIONS</code></a>. This means that a library which
provides an alternative translation system for Qt may specify options which
should be used when running <code class="docutils literal notranslate">uic</code>:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_library(KI18n klocalizedstring.cpp)
target_link_libraries(KI18n Qt5::Core)

# KI18n uses the tr2i18n() function instead of tr(). That function is
# declared in the klocalizedstring.h header.
set(autouic_options
 -tr tr2i18n
 -include klocalizedstring.h
)

set_property(TARGET KI18n APPEND PROPERTY
 INTERFACE_AUTOUIC_OPTIONS ${autouic_options}
)
</pre></div>
</div>
A consuming project linking to the target exported from upstream automatically
uses appropriate options when <code class="docutils literal notranslate">uic</code> is run by <a class="reference internal" href="../prop_tgt/AUTOUIC.html#prop_tgt:AUTOUIC" title="AUTOUIC"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOUIC</code></a>, as a
result of linking with the <a class="reference internal" href="../prop_tgt/IMPORTED.html#prop_tgt:IMPORTED" title="IMPORTED"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">IMPORTED</code></a> target:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>set(CMAKE_AUTOUIC ON)
# Uses a libwidget.ui file:
add_library(LibWidget libwidget.cpp)
target_link_libraries(LibWidget
 KF5::KI18n
 Qt5::Widgets
)
</pre></div>
</div>
Source files can be excluded from <a class="reference internal" href="../prop_tgt/AUTOUIC.html#prop_tgt:AUTOUIC" title="AUTOUIC"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOUIC</code></a> processing by
enabling <a class="reference internal" href="../prop_sf/SKIP_AUTOUIC.html#prop_sf:SKIP_AUTOUIC" title="SKIP_AUTOUIC"><code class="xref cmake cmake-prop_sf docutils literal notranslate">SKIP_AUTOUIC</code></a> or the broader <a class="reference internal" href="../prop_sf/SKIP_AUTOGEN.html#prop_sf:SKIP_AUTOGEN" title="SKIP_AUTOGEN"><code class="xref cmake cmake-prop_sf docutils literal notranslate">SKIP_AUTOGEN</code></a>.
</section>
<section id="autorcc">
<h3><a class="toc-backref" href="#id6" role="doc-backlink">AUTORCC</a><a class="headerlink" href="#autorcc" title="Permalink to this heading">¶</a></h3>
The <a class="reference internal" href="../prop_tgt/AUTORCC.html#prop_tgt:AUTORCC" title="AUTORCC"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTORCC</code></a> target property controls whether <a class="reference internal" href="cmake.1.html#manual:cmake(1)" title="cmake(1)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake(1)</code></a>
creates rules to execute <code class="docutils literal notranslate">rcc</code> at the appropriate time on source files
which have the suffix <code class="docutils literal notranslate">.qrc</code>.
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_executable(myexe main.cpp resource_file.qrc)
</pre></div>
</div>
The <a class="reference internal" href="../prop_tgt/AUTORCC.html#prop_tgt:AUTORCC" title="AUTORCC"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTORCC</code></a> target property may be pre-set for all following targets
by setting the <a class="reference internal" href="../variable/CMAKE_AUTORCC.html#variable:CMAKE_AUTORCC" title="CMAKE_AUTORCC"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_AUTORCC</code></a> variable. The
<a class="reference internal" href="../prop_tgt/AUTORCC_OPTIONS.html#prop_tgt:AUTORCC_OPTIONS" title="AUTORCC_OPTIONS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTORCC_OPTIONS</code></a> target property may be populated to set options
to pass to <code class="docutils literal notranslate">rcc</code>. The <a class="reference internal" href="../variable/CMAKE_AUTORCC_OPTIONS.html#variable:CMAKE_AUTORCC_OPTIONS" title="CMAKE_AUTORCC_OPTIONS"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_AUTORCC_OPTIONS</code></a> variable may be
populated to pre-set the options for all following targets. The
<a class="reference internal" href="../prop_sf/AUTORCC_OPTIONS.html#prop_sf:AUTORCC_OPTIONS" title="AUTORCC_OPTIONS"><code class="xref cmake cmake-prop_sf docutils literal notranslate">AUTORCC_OPTIONS</code></a> source file property may be set on the
<code class="docutils literal notranslate">&lt;name&gt;.qrc</code> file to set particular options for the file. This
overrides options from the <a class="reference internal" href="../prop_tgt/AUTORCC_OPTIONS.html#prop_tgt:AUTORCC_OPTIONS" title="AUTORCC_OPTIONS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTORCC_OPTIONS</code></a> target property.
Source files can be excluded from <a class="reference internal" href="../prop_tgt/AUTORCC.html#prop_tgt:AUTORCC" title="AUTORCC"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTORCC</code></a> processing by
enabling <a class="reference internal" href="../prop_sf/SKIP_AUTORCC.html#prop_sf:SKIP_AUTORCC" title="SKIP_AUTORCC"><code class="xref cmake cmake-prop_sf docutils literal notranslate">SKIP_AUTORCC</code></a> or the broader <a class="reference internal" href="../prop_sf/SKIP_AUTOGEN.html#prop_sf:SKIP_AUTOGEN" title="SKIP_AUTOGEN"><code class="xref cmake cmake-prop_sf docutils literal notranslate">SKIP_AUTOGEN</code></a>.
</section>
</section>
<section id="the-origin-autogen-target">
<h2><a class="toc-backref" href="#id7" role="doc-backlink">The <code class="docutils literal notranslate">&lt;ORIGIN&gt;_autogen</code> target</a><a class="headerlink" href="#the-origin-autogen-target" title="Permalink to this heading">¶</a></h2>
The <code class="docutils literal notranslate">moc</code> and <code class="docutils literal notranslate">uic</code> tools are executed as part of a synthesized
<code class="docutils literal notranslate">&lt;ORIGIN&gt;_autogen</code> <a class="reference internal" href="../command/add_custom_target.html#command:add_custom_target" title="add_custom_target"><code class="xref cmake cmake-command docutils literal notranslate">custom target</code></a> generated by
CMake. By default that <code class="docutils literal notranslate">&lt;ORIGIN&gt;_autogen</code> target inherits the dependencies
of the <code class="docutils literal notranslate">&lt;ORIGIN&gt;</code> target (see <a class="reference internal" href="../prop_tgt/AUTOGEN_ORIGIN_DEPENDS.html#prop_tgt:AUTOGEN_ORIGIN_DEPENDS" title="AUTOGEN_ORIGIN_DEPENDS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOGEN_ORIGIN_DEPENDS</code></a>).
Target dependencies may be added to the <code class="docutils literal notranslate">&lt;ORIGIN&gt;_autogen</code> target by adding
them to the <a class="reference internal" href="../prop_tgt/AUTOGEN_TARGET_DEPENDS.html#prop_tgt:AUTOGEN_TARGET_DEPENDS" title="AUTOGEN_TARGET_DEPENDS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOGEN_TARGET_DEPENDS</code></a> target property.
</section>
<section id="visual-studio-generators">
<h2><a class="toc-backref" href="#id8" role="doc-backlink">Visual Studio Generators</a><a class="headerlink" href="#visual-studio-generators" title="Permalink to this heading">¶</a></h2>
When using the <a class="reference internal" href="cmake-generators.7.html#manual:cmake-generators(7)" title="cmake-generators(7)"><code class="xref cmake cmake-manual docutils literal notranslate">Visual Studio generators</code></a>, CMake
generates a <code class="docutils literal notranslate">PRE_BUILD</code> <a class="reference internal" href="../command/add_custom_command.html#command:add_custom_command" title="add_custom_command"><code class="xref cmake cmake-command docutils literal notranslate">custom command</code></a>
instead of the <code class="docutils literal notranslate">&lt;ORIGIN&gt;_autogen</code> <a class="reference internal" href="../command/add_custom_target.html#command:add_custom_target" title="add_custom_target"><code class="xref cmake cmake-command docutils literal notranslate">custom target</code></a>
(for <a class="reference internal" href="../prop_tgt/AUTOMOC.html#prop_tgt:AUTOMOC" title="AUTOMOC"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOMOC</code></a> and <a class="reference internal" href="../prop_tgt/AUTOUIC.html#prop_tgt:AUTOUIC" title="AUTOUIC"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOUIC</code></a>).
This isn't always possible though and
an <code class="docutils literal notranslate">&lt;ORIGIN&gt;_autogen</code> <a class="reference internal" href="../command/add_custom_target.html#command:add_custom_target" title="add_custom_target"><code class="xref cmake cmake-command docutils literal notranslate">custom target</code></a> is used,
when either
<ul class="simple">
<li>the <code class="docutils literal notranslate">&lt;ORIGIN&gt;</code> target depends on <a class="reference internal" href="../prop_sf/GENERATED.html#prop_sf:GENERATED" title="GENERATED"><code class="xref cmake cmake-prop_sf docutils literal notranslate">GENERATED</code></a> files which aren't
excluded from <a class="reference internal" href="../prop_tgt/AUTOMOC.html#prop_tgt:AUTOMOC" title="AUTOMOC"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOMOC</code></a> and <a class="reference internal" href="../prop_tgt/AUTOUIC.html#prop_tgt:AUTOUIC" title="AUTOUIC"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOUIC</code></a> by
<a class="reference internal" href="../prop_sf/SKIP_AUTOMOC.html#prop_sf:SKIP_AUTOMOC" title="SKIP_AUTOMOC"><code class="xref cmake cmake-prop_sf docutils literal notranslate">SKIP_AUTOMOC</code></a>, <a class="reference internal" href="../prop_sf/SKIP_AUTOUIC.html#prop_sf:SKIP_AUTOUIC" title="SKIP_AUTOUIC"><code class="xref cmake cmake-prop_sf docutils literal notranslate">SKIP_AUTOUIC</code></a>, <a class="reference internal" href="../prop_sf/SKIP_AUTOGEN.html#prop_sf:SKIP_AUTOGEN" title="SKIP_AUTOGEN"><code class="xref cmake cmake-prop_sf docutils literal notranslate">SKIP_AUTOGEN</code></a>
or <a class="reference internal" href="../policy/CMP0071.html#policy:CMP0071" title="CMP0071"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0071</code></a></li>
<li><a class="reference internal" href="../prop_tgt/AUTOGEN_TARGET_DEPENDS.html#prop_tgt:AUTOGEN_TARGET_DEPENDS" title="AUTOGEN_TARGET_DEPENDS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOGEN_TARGET_DEPENDS</code></a> lists a source file</li>
<li><a class="reference internal" href="../variable/CMAKE_GLOBAL_AUTOGEN_TARGET.html#variable:CMAKE_GLOBAL_AUTOGEN_TARGET" title="CMAKE_GLOBAL_AUTOGEN_TARGET"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_GLOBAL_AUTOGEN_TARGET</code></a> is enabled</li>
</ul>
</section>
<section id="qtmain-lib-on-windows">
<h2><a class="toc-backref" href="#id9" role="doc-backlink">qtmain.lib on Windows</a><a class="headerlink" href="#qtmain-lib-on-windows" title="Permalink to this heading">¶</a></h2>
The Qt 4 and 5 <a class="reference internal" href="../prop_tgt/IMPORTED.html#prop_tgt:IMPORTED" title="IMPORTED"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">IMPORTED</code></a> targets for the QtGui libraries specify
that the qtmain.lib static library shipped with Qt will be linked by all
dependent executables which have the <a class="reference internal" href="../prop_tgt/WIN32_EXECUTABLE.html#prop_tgt:WIN32_EXECUTABLE" title="WIN32_EXECUTABLE"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">WIN32_EXECUTABLE</code></a> enabled.
To disable this behavior, enable the <code class="docutils literal notranslate">Qt5_NO_LINK_QTMAIN</code> target property for
Qt 5 based targets or <code class="docutils literal notranslate">QT4_NO_LINK_QTMAIN</code> target property for Qt 4 based
targets.
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_executable(myexe WIN32 main.cpp)
target_link_libraries(myexe Qt4::QtGui)

add_executable(myexe_no_qtmain WIN32 main_no_qtmain.cpp)
set_property(TARGET main_no_qtmain PROPERTY QT4_NO_LINK_QTMAIN ON)
target_link_libraries(main_no_qtmain Qt4::QtGui)
</pre></div>
</div>
</section>
</section>

<div class="clearer"></div>
 </div>
 </div>
 </div>
 <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 <div class="sphinxsidebarwrapper">
 <div>
 <h3><a href="../index.html">Table of Contents</a></h3>
 <ul>
<li><a class="reference internal" href="#">cmake-qt(7)</a><ul>
<li><a class="reference internal" href="#introduction">Introduction</a></li>
<li><a class="reference internal" href="#qt-build-tools">Qt Build Tools</a><ul>
<li><a class="reference internal" href="#automoc">AUTOMOC</a></li>
<li><a class="reference internal" href="#autouic">AUTOUIC</a></li>
<li><a class="reference internal" href="#autorcc">AUTORCC</a></li>
</ul>
</li>
<li><a class="reference internal" href="#the-origin-autogen-target">The <code class="docutils literal notranslate">&lt;ORIGIN&gt;_autogen</code> target</a></li>
<li><a class="reference internal" href="#visual-studio-generators">Visual Studio Generators</a></li>
<li><a class="reference internal" href="#qtmain-lib-on-windows">qtmain.lib on Windows</a></li>
</ul>
</li>
</ul>

</div>
 <div>
 <h4>Previous topic</h4>
 <a href="../prop_sf/COMPILE_DEFINITIONS_CONFIG.html"
 title="previous chapter">COMPILE_DEFINITIONS_&lt;CONFIG&gt;</a>
 </div>
 <div>
 <h4>Next topic</h4>
 <a href="cmake-server.7.html"
 title="next chapter">cmake-server(7)</a>
 </div>
 <div role="note" aria-label="source link">
 <h3>This Page</h3>
 <ul class="this-page-menu">
 <li><a href="../_sources/manual/cmake-qt.7.rst.txt"
 rel="nofollow">Show Source</a></li>
 </ul>
 </div>
<div id="searchbox" style="display: none" role="search">
 <h3 id="searchlabel">Quick search</h3>
 <div class="searchformwrapper">
 <form class="search" action="../search.html" method="get">
 <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
 <input type="submit" value="Go" />
 </form>
 </div>
</div>
<script>document.getElementById('searchbox').style.display = "block"</script>
 </div>
 </div>
 <div class="clearer"></div>
 </div>
 <div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="../genindex.html" title="General Index"
 >index</a></li>
 <li class="right" >
 <a href="cmake-server.7.html" title="cmake-server(7)"
 >next</a> |</li>
 <li class="right" >
 <a href="../prop_sf/COMPILE_DEFINITIONS_CONFIG.html" title="COMPILE_DEFINITIONS_&lt;CONFIG&gt;"
 >previous</a> |</li>
 <li>
 <img src="../_static/cmake-logo-16.png" alt=""
 style="vertical-align: middle; margin-top: -2px" />
 </li>
 <li>
 <a href="https://cmake.org/">CMake</a> &#187;
 </li>
 <li>
 <a href="../index.html">3.26.3 Documentation</a> &#187;
 </li>

<li class="nav-item nav-item-this"><a href="">cmake-qt(7)</a></li> 
 </ul>
 </div>

<div class="footer" role="contentinfo">
 &#169; Copyright 2000-2023 Kitware, Inc. and Contributors.
 Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 5.0.2.
 </div>
 </body>
</html>