1/****************************************************************************
2**
3** Copyright (C) 2016 The Qt Company Ltd.
4** Contact: https://www.qt.io/licensing/
5**
6** This file is part of the QtQuick module of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL$
9** Commercial License Usage
10** Licensees holding valid commercial Qt licenses may use this file in
11** accordance with the commercial license agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and The Qt Company. For licensing terms
14** and conditions see https://www.qt.io/terms-conditions. For further
15** information use the contact form at https://www.qt.io/contact-us.
16**
17** GNU Lesser General Public License Usage
18** Alternatively, this file may be used under the terms of the GNU Lesser
19** General Public License version 3 as published by the Free Software
20** Foundation and appearing in the file LICENSE.LGPL3 included in the
21** packaging of this file. Please review the following information to
22** ensure the GNU Lesser General Public License version 3 requirements
23** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
24**
25** GNU General Public License Usage
26** Alternatively, this file may be used under the terms of the GNU
27** General Public License version 2.0 or (at your option) the GNU General
28** Public license version 3 or any later version approved by the KDE Free
29** Qt Foundation. The licenses are as published by the Free Software
30** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
31** included in the packaging of this file. Please review the following
32** information to ensure the GNU General Public License requirements will
33** be met: https://www.gnu.org/licenses/gpl-2.0.html and
34** https://www.gnu.org/licenses/gpl-3.0.html.
35**
36** $QT_END_LICENSE$
37**
38****************************************************************************/
39
40#ifndef QQUICKVIEW_H
41#define QQUICKVIEW_H
42
43#include <QtQuick/qquickwindow.h>
44#include <QtCore/qurl.h>
45
46QT_BEGIN_NAMESPACE
47
48class QQmlEngine;
49class QQmlContext;
50class QQmlError;
51class QQuickItem;
52class QQmlComponent;
53
54class QQuickViewPrivate;
55class Q_QUICK_EXPORT QQuickView : public QQuickWindow
56{
57 Q_OBJECT
58 Q_PROPERTY(ResizeMode resizeMode READ resizeMode WRITE setResizeMode)
59 Q_PROPERTY(Status status READ status NOTIFY statusChanged)
60 Q_PROPERTY(QUrl source READ source WRITE setSource DESIGNABLE true)
61public:
62 explicit QQuickView(QWindow *parent = nullptr);
63 QQuickView(QQmlEngine* engine, QWindow *parent);
64 explicit QQuickView(const QUrl &source, QWindow *parent = nullptr);
65 QQuickView(const QUrl &source, QQuickRenderControl *renderControl);
66 ~QQuickView() override;
67
68 QUrl source() const;
69
70 QQmlEngine* engine() const;
71 QQmlContext* rootContext() const;
72
73 QQuickItem *rootObject() const;
74
75 enum ResizeMode { SizeViewToRootObject, SizeRootObjectToView };
76 Q_ENUM(ResizeMode)
77 ResizeMode resizeMode() const;
78 void setResizeMode(ResizeMode);
79
80 enum Status { Null, Ready, Loading, Error };
81 Q_ENUM(Status)
82 Status status() const;
83
84 QList<QQmlError> errors() const;
85
86 QSize sizeHint() const;
87 QSize initialSize() const;
88
89public Q_SLOTS:
90 void setSource(const QUrl&);
91 void setInitialProperties(const QVariantMap &initialProperties);
92 void setContent(const QUrl& url, QQmlComponent *component, QObject *item);
93
94Q_SIGNALS:
95 void statusChanged(QQuickView::Status);
96
97private Q_SLOTS:
98 void continueExecute();
99
100protected:
101 void resizeEvent(QResizeEvent *) override;
102 void timerEvent(QTimerEvent*) override;
103
104 void keyPressEvent(QKeyEvent *) override;
105 void keyReleaseEvent(QKeyEvent *) override;
106 void mousePressEvent(QMouseEvent *) override;
107 void mouseReleaseEvent(QMouseEvent *) override;
108 void mouseMoveEvent(QMouseEvent *) override;
109private:
110 Q_DISABLE_COPY(QQuickView)
111 Q_DECLARE_PRIVATE(QQuickView)
112};
113
114QT_END_NAMESPACE
115
116#endif // QQUICKVIEW_H
117

source code of qtdeclarative/src/quick/items/qquickview.h