/usr/share/qt5/doc/qtquickcontrols/qtquickcontrols-overview.html is in qtquickcontrols5-doc-html 5.5.1-1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qtquickcontrols-overview.qdoc -->
<title>Qt Quick Controls Overview | Qt Quick Controls 5.5</title>
<link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="header" id="qtdocheader">
<div class="main">
<div class="main-rounded">
<div class="navigationbar">
<ul>
<li>Qt 5.5</li>
<li><a href="qtquickcontrols-index.html">Qt Quick Controls</a></li>
<li>Qt Quick Controls Overview</li>
<li id="buildversion">Qt 5.5.1 Reference Documentation</li>
</ul>
</div>
</div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="sidebar">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#getting-started">Getting Started</a></li>
<li class="level1"><a href="#creating-a-basic-example">Creating a basic example</a></li>
<li class="level1"><a href="#setting-up-controls-from-c">Setting Up Controls from C++</a></li>
<li class="level2"><a href="#using-c-data-from-qml">Using C++ Data From QML</a></li>
<li class="level2"><a href="#deploying-qt-quick-controls">Deploying Qt Quick Controls</a></li>
<li class="level1"><a href="#related-information">Related information</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">Qt Quick Controls Overview</h1>
<span class="subtitle"></span>
<!-- $$$qtquickcontrols-overview.html-description -->
<div class="descr"> <a name="details"></a>
<p>The Qt Quick Controls provide a set of UI controls to create user interfaces in Qt Quick.</p>
<a name="getting-started"></a>
<h2 id="getting-started">Getting Started</h2>
<p>The QML types can be imported into your application using the following import statement in your <code>.qml</code> file.</p>
<pre class="cpp">import <span class="type"><a href="../qtqml/qtquick-qmlmodule.html">QtQuick</a></span><span class="operator">.</span>Controls <span class="number">1.2</span></pre>
<a name="creating-a-basic-example"></a>
<h2 id="creating-a-basic-example">Creating a basic example</h2>
<p>A basic example of a QML file that makes use of controls is shown here:</p>
<pre class="cpp">import <span class="type"><a href="../qtqml/qtquick-qmlmodule.html">QtQuick</a></span><span class="operator">.</span>Controls <span class="number">1.2</span>
ApplicationWindow {
title: <span class="string">"My Application"</span>
width: <span class="number">640</span>
height: <span class="number">480</span>
visible: <span class="keyword">true</span>
Button {
text: <span class="string">"Push Me"</span>
anchors<span class="operator">.</span>centerIn: parent
}
}</pre>
<p>For an overview of the controls provided by <a href="qtquickcontrols-index.html">Qt Quick Controls</a>, you can look at the <a href="qtquickcontrols-gallery-example.html">Gallery</a> example.</p>
<p class="centerAlign"><img src="images/qtquickcontrols-example-gallery-osx.png" alt="" /></p><a name="setting-up-controls-from-c"></a>
<h2 id="setting-up-controls-from-c">Setting Up Controls from C++</h2>
<p>Although we have traditionally used a <a href="../qtquick/qquickview.html">QQuickView</a> window to display QML files in a C++ application, doing this means you can only set window properties from C++.</p>
<p>With Qt Quick Controls, declare an <a href="qml-qtquick-controls-applicationwindow.html">ApplicationWindow</a> as the root item of your application and launch it by using the <a href="../qtqml/qqmlapplicationengine.html">QQmlApplicationEngine</a> instead. This ensures that you can control top level window properties from QML.</p>
<p>A basic example of a source file that makes use of controls is shown here:</p>
<pre class="cpp"><span class="preprocessor">#include <QApplication></span>
<span class="preprocessor">#include <QQmlApplicationEngine></span>
<span class="type">int</span> main(<span class="type">int</span> argc<span class="operator">,</span> <span class="type">char</span> <span class="operator">*</span>argv<span class="operator">[</span><span class="operator">]</span>)
{
<span class="type"><a href="../qtwidgets/qapplication.html">QApplication</a></span> app(argc<span class="operator">,</span> argv);
<span class="type"><a href="../qtqml/qqmlapplicationengine.html">QQmlApplicationEngine</a></span> engine(<span class="string">"main.qml"</span>);
<span class="keyword">return</span> app<span class="operator">.</span>exec();
}</pre>
<p><b>Note: </b>We are using <a href="../qtwidgets/qapplication.html">QApplication</a> and not <a href="../qtgui/qguiapplication.html">QGuiApplication</a> in this example. Though you can use <a href="../qtgui/qguiapplication.html">QGuiApplication</a> instead, doing this will eliminate platform-dependent styling. This is because it is relying on the widget module to provide the native look and feel.</p><a name="using-c-data-from-qml"></a>
<h3 >Using C++ Data From QML</h3>
<p>If you need to register a C++ class to use from QML, you can call, for example, <a href="../qtqml/qqmlengine.html#qmlRegisterType">qmlRegisterType</a>() before declaring your <a href="../qtqml/qqmlapplicationengine.html">QQmlApplicationEngine</a>. You can find the list of all registering functions <a href="../qtqml/qqmlengine.html">here</a>.</p>
<p>If you need to expose data to QML components, you need to set them to the context of the current QML engine. See <a href="../qtqml/qqmlcontext.html">QQmlContext</a> for more information.</p>
<a name="deploying-qt-quick-controls"></a>
<h3 >Deploying Qt Quick Controls</h3>
<p>Since Qt 5.2, the Qt Quick Controls JavaScript and QML files are embedded into the plugin using <a href="../qtcore/resources.html">Qt resources</a> (.qrc) for the <a href="../qtqml/qtquick-qmlmodule.html">QtQuick</a>.Controls and <a href="../qtqml/qtquick-qmlmodule.html">QtQuick</a>.Controls.Styles imports. It is only necessary to deploy the qtquickcontrolsplugin C++ library and its qmldir file found in the plugin directory <i>qml/<a href="../qtqml/qtquick-qmlmodule.html">QtQuick</a>/Controls</i>.</p>
<p>The .js/.qml files are still placed into the plugin directory though for keeping the development tasks convenient, debugging and autocompletion capabilities remain unchanged. For deployment, these files can be ignored. In practice, the <i>Styles</i> and <i>Private</i> subfolders can be deleted as well as all .js and .qml files present under <i>qml/<a href="../qtqml/qtquick-qmlmodule.html">QtQuick</a>/Controls</i>.</p>
<p><b>Note: </b>On Windows, the Windows Deployment Tool only deploys the Qt Quick Controls plugin and its qmldir file.</p><p>Using resources facilitates the deployment of the Qt Quick Controls though it has limitations that still need to be addressed.</p>
<p><b>Note: </b>On iOS, the qmlimportscanner tool is used to parse the required qml imports so they can be deployed accordingly. The files embedded in resources are not scanned by this tool though and when linking statically, some required imports used by the Qt Quick Controls can be forgotten. This is a known limitation and a workaround is to add potentially missing imports in one of the qml files of the application using the controls.</p><a name="related-information"></a>
<h2 id="related-information">Related information</h2>
<ul>
<li><a href="../qtquick/qtquick-index.html">Qt Quick</a></li>
<li><a href="qtquickcontrols-index.html">Qt Quick Controls</a></li>
<li><a href="qtquickcontrols-examples.html">Qt Quick Controls Examples</a></li>
</ul>
</div>
<!-- @@@qtquickcontrols-overview.html -->
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2015 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.<br> The documentation provided herein is licensed under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License version 1.3</a> as published by the Free Software Foundation.<br> Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. </p>
</div>
</body>
</html>
|