feedc0de/qt-creator
1
0
Fork 0
forked from qt-creator/qt-creator
Code Pull Requests Activity

Doc: Remove obsolete instructions for registering QML types

Browse Source 
QML types are now registered automatically in most cases.

Task-number: QTCREATORBUG-26617
Change-Id: I4f1e2a731893081cbb0c399e7742b3656f201a1d
Reviewed-by: Fabian Kosmale <fabian.kosmale@qt.io>
Reviewed-by: Thomas Hartmann <thomas.hartmann@qt.io>
This commit is contained in:
Leena Miettinen
2022-05-02 15:56:18 +02:00
parent 0d9fc1fe11
commit 6537f1cadc
1 changed files with 12 additions and 28 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
doc/qtcreator/src/qtquick/qtquick-modules-with-plugins.qdoc
View File

@@ -41,16 +41,14 @@
\title Using QML Modules with Plugins \title Using QML Modules with Plugins
QML modules may use plugins to expose components defined in C++ to QML \l{Defining a QML Module}{QML modules} may use \l{Creating C++ Plugins for QML}
applications. \QC cannot load the plugins to determine the details of {C++ plugins} to expose components defined in C++ to QML applications.
the contained components, and therefore, the modules must provide extra type
information for code completion and the semantic checks to work correctly.
To create a QML module To create a QML
\if defined(qtdesignstudio) \if defined(qtdesignstudio)
and make it appear in the \l Components view: module and make it appear in the \l Components view:
\else \else
: module:
\endif \endif
\list 1 \list 1
@@ -97,26 +95,13 @@
\c .metainfo file is in place. \c .metainfo file is in place.
\endif \endif
\if defined(qtcreator)
\section1 Registering QML Types
When you write a QML module or use QML from a C++ application, and the C++
is a part of your qmake project, you typically register new types with the
\c qmlRegisterType() function or expose some class instances with
\l{QQmlContext::setContextProperty()}. The \QC C++ code model now scans for
these calls and tells the QML code model about them. This means that properties
are displayed during code completion and the JavaScript code checker does not
complain about unknown types. However, this works only when the source code
is available, and therefore, you must explicitly generate type information
for QML modules with plugins before distributing them.
\endif
\section1 Generating Type Description Files \section1 Generating Type Description Files
Ideally, QML modules have a \c{plugins.qmltypes} file in the same directory When \l{Defining QML Types from C++}{registering QML types}, make sure that
as the \c qmldir file. The \c qmltypes file contains a description of the the QML module has a \c{plugins.qmltypes} file. Ideally, it should be located
components exported by the module's plugins and is loaded by \QC when the in the same directory as the \c qmldir file. The \c qmltypes file contains a
module is imported. description of the components exported by the module's plugins and is loaded
by \QC when the module is imported.
For more information, see \l{Type Description Files}. For more information, see \l{Type Description Files}.
@@ -127,7 +112,6 @@
However, this automatic dumping is a fallback mechanism with many points of However, this automatic dumping is a fallback mechanism with many points of
failure and you cannot rely upon it. failure and you cannot rely upon it.
\if defined(qtcreator)
\section1 Importing QML Modules \section1 Importing QML Modules
By default, \QC will look in the QML import path of Qt for QML modules. By default, \QC will look in the QML import path of Qt for QML modules.
@@ -145,7 +129,7 @@
The import path affects all the targets built by the CMake project. The import path affects all the targets built by the CMake project.
\else \if defined(qtdesignstudio)
\section1 Running QML Modules in Design Mode \section1 Running QML Modules in Design Mode
A QML emulation layer (also called QML Puppet) is used in the A QML emulation layer (also called QML Puppet) is used in the