aboutsummaryrefslogtreecommitdiffstats
path: root/src/qml/doc/src/cmake/cmake-properties.qdoc
blob: 1441419e5bdd5725026c4301f0b03056e1dc75db (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
// Copyright (C) 2022 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

/*!
\group cmake-source-file-properties-qtqml
\title CMake Source File Properties in Qt6 Qml

\l{CMake Commands in Qt6 Qml}{CMake Commands} know about the following CMake
source file properties:

\sa{CMake Property Reference}
*/


/*!
\page cmake-source-file-property-QT_QML_INTERNAL_TYPE.html
\ingroup cmake-source-file-properties-qtqml

\title QT_QML_INTERNAL_TYPE
\target cmake-source-file-property-QT_QML_INTERNAL_TYPE

\summary {Marks a QML file as providing an internal type.}

\cmakepropertysince 6.2

Set this property to \c TRUE to indicate that the \c{.qml} file provides an internal type.

\sa{qml-source-file-properties}{qt_target_qml_sources}
*/


/*!
\page cmake-source-file-property-QT_QML_SINGLETON_TYPE.html
\ingroup cmake-source-file-properties-qtqml

\title QT_QML_SINGLETON_TYPE
\target cmake-source-file-property-QT_QML_SINGLETON_TYPE

\summary {Marks a QML file as providing a singleton type.}

\cmakepropertysince 6.2

A \c{.qml} file that provides a singleton type needs to have its \c QT_QML_SINGLETON_TYPE source
property set to \c TRUE to ensure that the singleton command is written into the
\l{Module Definition qmldir Files}{qmldir} file.
This must be done in addition to the QML file containing the \c {pragma Singleton} statement.

See \l{qt_target_qml_sources_example}{qt_target_qml_sources()} for an example on
how to set the \c QT_QML_SINGLETON_TYPE property.

\sa{qml-source-file-properties}{qt_target_qml_sources}
*/


/*!
\page cmake-source-file-property-QT_QML_SKIP_CACHEGEN.html
\ingroup cmake-source-file-properties-qtqml

\title QT_QML_SKIP_CACHEGEN
\target cmake-source-file-property-QT_QML_SKIP_CACHEGEN

\summary {Excludes a file from being compiled to byte code.}

\cmakepropertysince 6.2

Set this property to \c TRUE to prevent the \c{.qml} file from being compiled to byte code.
The file will still be added to the \c target as a resource in uncompiled form
(see \l{qmlcachegen-auto}{Caching compiled QML sources}).

\sa{qml-source-file-properties}{qt_target_qml_sources}
*/


/*!
\page cmake-source-file-property-QT_QML_SKIP_QMLDIR_ENTRY.html
\ingroup cmake-source-file-properties-qtqml

\title QT_QML_SKIP_QMLDIR_ENTRY
\target cmake-source-file-property-QT_QML_SKIP_QMLDIR_ENTRY

\summary {Excludes a file from being added as a type to the QML module's typeinfo file.}

\cmakepropertysince 6.2

Set this property to \c TRUE to prevent
the \c{.qml} file from being added as a type to the QML module's typeinfo file
(see \l{qmldir-autogeneration}{Auto-generating \c{qmldir} and typeinfo files}).

\sa{qml-source-file-properties}{qt_target_qml_sources}
*/


/*!
\page cmake-source-file-property-QT_QML_SKIP_QMLLINT.html
\ingroup cmake-source-file-properties-qtqml

\title QT_QML_SKIP_QMLLINT
\target cmake-source-file-property-QT_QML_SKIP_QMLLINT

\summary {Prevents a file from being included in automatic qmllint processing.}

\cmakepropertysince 6.2

Set this property to \c TRUE to prevent the file from being included in
\l{qmllint-auto}{automatic qmllint processing}.

\sa{qml-source-file-properties}{qt_target_qml_sources}
*/


/*!
\page cmake-source-file-property-QT_QML_SOURCE_TYPENAME.html
\ingroup cmake-source-file-properties-qtqml

\title QT_QML_SOURCE_TYPENAME
\target cmake-source-file-property-QT_QML_SOURCE_TYPENAME

\summary {Overrides the type name provided by the file.}

\cmakepropertysince 6.2

Use this property to override the \c QML type name provided by this file.

\sa{qml-source-file-properties}{qt_target_qml_sources}
*/


/*!
\page cmake-source-file-property-QT_QML_SOURCE_VERSIONS.html
\ingroup cmake-source-file-properties-qtqml

\title QT_QML_SOURCE_VERSIONS
\target cmake-source-file-property-QT_QML_SOURCE_VERSIONS

\summary {Specifies a custom set of versions for a type.}

\cmakepropertysince 6.2

When the file needs to provide type entries for a custom set of versions,
for example when the QML types were first introduced in a minor patch
version after the \c{.0} release, specify those versions using this property.

\sa{qml-source-file-properties}{qt_target_qml_sources}
*/


/*!
\page cmake-source-file-property-QT_QMLTC_FILE_BASENAME.html
\ingroup cmake-source-file-properties-qtqml

\title QT_QMLTC_FILE_BASENAME
\target cmake-source-file-property-QT_QMLTC_FILE_BASENAME

\summary {Specifies a non-default .h and .cpp file name.}

\cmakepropertysince 6.3
\preliminarycmakeproperty

Use this property to specify a non-default \c .h and \c .cpp file name, which helps to resolve
conflicting file names.

\sa{qmltc-cmake}
*/

/*!
\page cmake-source-file-property-QT_QML_SKIP_TYPE_COMPILER.html
\ingroup cmake-source-file-properties-qtqml

\title QT_QML_SKIP_TYPE_COMPILER
\target cmake-source-file-property-QT_QML_SKIP_TYPE_COMPILER

\summary {Excludes a file from being compiled to C++ using qmltc.}

\cmakepropertysince 6.4
\preliminarycmakeproperty

Set this property to \c TRUE to prevent the \c{.qml} file from being compiled to
C++ during qmltc compilation.

\sa{qmltc-cmake}
*/