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
|
/****************************************************************************
**
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
** Contact: http://www.qt-project.org/legal
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:FDL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and Digia. For licensing terms and
** conditions see http://qt.digia.com/licensing. For further information
** use the contact form at http://qt.digia.com/contact-us.
**
** GNU Free Documentation License Usage
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of
** this file. Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: http://www.gnu.org/copyleft/fdl.html.
** $QT_END_LICENSE$
**
****************************************************************************/
/*!
\title Qt Quick Examples - Window and Screen
\example window
\brief This example demonstrates the Window and Screen types in QML
\image qml-window-example.png
\ingroup qtquickexamples
This example shows you how to create a Window in QML, how to control its
\l {QQuickWindow::visibility} {visibility}, how to present a splash screen
during application startup, and how to access the properties of the
\l Screen. It also demonstrates how to package QML into
\l {The Qt Resource System} {resources} and provide an
\l {Setting the Application Icon} {icon} to create a standalone QML desktop application.
A splash screen can be created with the \l {Qt::SplashScreen} {Qt.SplashScreen} flag,
and should be \l {Qt::ApplicationModal} {ApplicationModal} to prevent interaction
with the main window. If the splash window is also transparent, and showing a
partially transparent image, then it will look like a shaped window.
\snippet window/Splash.qml splash-properties
In this example a \l Timer will automatically dismiss the splash screen,
but in a real application you might want to connect to a signal from the
application logic to hide the splash when initialization is complete.
\snippet window/Splash.qml timer
The main window in this example is the control window, with some buttons
and checkboxes to control and provide feedback on the state of a secondary
window. Each checkbox has a binding to the property whose state it is
displaying, and also an onClicked handler to change the state. This is the
typical pattern to create a two-way binding while avoiding binding loops.
\snippet window/window.qml windowedCheckbox
The \l Screen has several properties which are generally useful to applications
which need to rotate some content when the screen orientation changes, to position
windows on the screen or to convert real units to logical pixel units. ScreenInfo.qml
(which is displayed inline in window.qml, or can be run by itself with qmlscene)
simply displays the property values, while the splash screen uses them to
center the window on the screen.
\snippet window/Splash.qml screen-properties
If a Window is nested inside an \l Item or another Window, the inner window
becomes "transient for" the outer one (see \l Window for more explanation).
But if you want to create multiple top-level windows as unrelated peers, you
can create them inside a non-visual \l QtObject root item, as this example does.
*/
|
