1/****************************************************************************
2**
3** Copyright (C) 2017 The Qt Company Ltd.
4** Contact: http://www.qt.io/licensing/
5**
6** This file is part of the Qt Quick Controls 2 module of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL3$
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 http://www.qt.io/terms-conditions. For further
15** information use the contact form at http://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.LGPLv3 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.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 later as published by the Free
28** Software Foundation and appearing in the file LICENSE.GPL included in
29** the packaging of this file. Please review the following information to
30** ensure the GNU General Public License version 2.0 requirements will be
31** met: http://www.gnu.org/licenses/gpl-2.0.html.
32**
33** $QT_END_LICENSE$
34**
35****************************************************************************/
36
37#ifndef QQUICKIMAGESELECTOR_P_H
38#define QQUICKIMAGESELECTOR_P_H
39
40//
41// W A R N I N G
42// -------------
43//
44// This file is not part of the Qt API. It exists purely as an
45// implementation detail. This header file may change from version to
46// version without notice, or even be removed.
47//
48// We mean it.
49//
50
51#include <QtCore/qurl.h>
52#include <QtCore/qobject.h>
53#include <QtCore/qvariant.h>
54#include <QtQml/qqmlproperty.h>
55#include <QtQml/qqmlparserstatus.h>
56#include <QtQml/private/qqmlpropertyvalueinterceptor_p.h>
57#include <QtQml/qqmlproperty.h>
58#include <QtQml/qqml.h>
59
60QT_BEGIN_NAMESPACE
61
62class QQuickImageSelector : public QObject, public QQmlParserStatus, public QQmlPropertyValueInterceptor
63{
64 Q_OBJECT
65 Q_PROPERTY(QUrl source READ source NOTIFY sourceChanged FINAL)
66 Q_PROPERTY(QString name READ name WRITE setName FINAL)
67 Q_PROPERTY(QString path READ path WRITE setPath FINAL)
68 Q_PROPERTY(QVariantList states READ states WRITE setStates FINAL)
69 Q_PROPERTY(QString separator READ separator WRITE setSeparator FINAL)
70 Q_PROPERTY(bool cache READ cache WRITE setCache FINAL)
71 Q_INTERFACES(QQmlParserStatus QQmlPropertyValueInterceptor)
72
73public:
74 explicit QQuickImageSelector(QObject *parent = nullptr);
75
76 QUrl source() const;
77 void setSource(const QUrl &source);
78
79 QString name() const;
80 void setName(const QString &name);
81
82 QString path() const;
83 void setPath(const QString &path);
84
85 QVariantList states() const;
86 void setStates(const QVariantList &states);
87
88 QString separator() const;
89 void setSeparator(const QString &separator);
90
91 bool cache() const;
92 void setCache(bool cache);
93
94 void write(const QVariant &value) override;
95 void setTarget(const QQmlProperty &property) override;
96
97Q_SIGNALS:
98 void sourceChanged();
99
100protected:
101 void classBegin() override;
102 void componentComplete() override;
103
104 virtual QStringList fileExtensions() const;
105
106 QString cacheKey() const;
107 void updateSource();
108 void setUrl(const QUrl &url);
109 bool updateActiveStates();
110 int calculateScore(const QStringList &states) const;
111
112private:
113 bool m_cache = false;
114 bool m_complete = false;
115 QUrl m_source;
116 QString m_path;
117 QString m_name;
118 QString m_separator = QLatin1String("-");
119 QVariantList m_allStates;
120 QStringList m_activeStates;
121 QQmlProperty m_property;
122};
123
124class QQuickNinePatchImageSelector : public QQuickImageSelector
125{
126 Q_OBJECT
127
128public:
129 explicit QQuickNinePatchImageSelector(QObject *parent = nullptr);
130
131protected:
132 QStringList fileExtensions() const override;
133};
134
135class QQuickAnimatedImageSelector : public QQuickImageSelector
136{
137 Q_OBJECT
138
139public:
140 explicit QQuickAnimatedImageSelector(QObject *parent = nullptr);
141
142protected:
143 QStringList fileExtensions() const override;
144};
145
146QT_END_NAMESPACE
147
148QML_DECLARE_TYPE(QQuickImageSelector)
149QML_DECLARE_TYPE(QQuickAnimatedImageSelector)
150
151#endif // QQUICKIMAGESELECTOR_P_H
152

source code of qtquickcontrols2/src/imports/controls/imagine/qquickimageselector_p.h