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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
|
/****************************************************************************
**
** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies).
** Contact: http://www.qt-project.org/legal
**
** This file is part of the QtDeclarative module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** GNU Lesser General Public License Usage
** This file may be used under the terms of the GNU Lesser General Public
** License version 2.1 as published by the Free Software Foundation and
** appearing in the file LICENSE.LGPL included in the packaging of this
** file. Please review the following information to ensure the GNU Lesser
** General Public License version 2.1 requirements will be met:
** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Nokia gives you certain additional
** rights. These rights are described in the Nokia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU General
** Public License version 3.0 as published by the Free Software Foundation
** and appearing in the file LICENSE.GPL included in the packaging of this
** file. Please review the following information to ensure the GNU General
** Public License version 3.0 requirements will be met:
** http://www.gnu.org/copyleft/gpl.html.
**
** Other Usage
** Alternatively, this file may be used in accordance with the terms and
** conditions contained in a signed written agreement between you and Nokia.
**
**
**
**
**
**
** $QT_END_LICENSE$
**
****************************************************************************/
#include "qdeclarativevaluespacesubscriber_p.h"
class QDeclarativeValueSpaceSubscriberPrivate
{
public:
QDeclarativeValueSpaceSubscriberPrivate();
~QDeclarativeValueSpaceSubscriberPrivate();
QValueSpaceSubscriber *subscriber;
// store our own copy, since the QVSS doesn't always seem
// to return the current path properly
QString path;
};
QDeclarativeValueSpaceSubscriberPrivate::QDeclarativeValueSpaceSubscriberPrivate() :
subscriber(0)
{
}
QDeclarativeValueSpaceSubscriberPrivate::~QDeclarativeValueSpaceSubscriberPrivate()
{
if (subscriber)
delete subscriber;
}
/*!
\qmlclass ValueSpaceSubscriber QDeclarativeValueSpaceSubscriber
\brief The QValueSpaceSubscriber class allows applications to read and
subscribe to Value Space paths.
\since Mobility 1.2
\ingroup qml-publishsubscribe
The ValueSpaceSubscriber element is part of the \bold {QtMobility.publishsubscribe 1.1} module.
Each \l ValueSpaceSubscriber element represents a single value or path in the Value Space. The
path is set using the \i path property.
Note that unlike the C++ class QValueSpaceSubscriber, the QML element has
no default path. A path must be set before the subscriber will connect
to the Value Space and begin receiving notifications.
\code
ValueSpaceSubscriber {
id: nowPlaying
path: "/applications/mediaplayer/now-playing"
}
\endcode
The value is accessed using the \i value property.
\code
Text {
text: nowPlaying.value
}
\endcode
*/
QDeclarativeValueSpaceSubscriber::QDeclarativeValueSpaceSubscriber() :
d(new QDeclarativeValueSpaceSubscriberPrivate)
{
}
QDeclarativeValueSpaceSubscriber::~QDeclarativeValueSpaceSubscriber()
{
delete d;
}
/*!
\qmlproperty string ValueSpaceSubscriber::path
\since Mobility 1.2
This property holds the base path of the subscriber, and is read/write.
*/
void QDeclarativeValueSpaceSubscriber::setPath(QString path)
{
if (d->subscriber) {
if (d->path == path)
return;
d->subscriber->setPath(path);
} else {
d->subscriber = new QValueSpaceSubscriber(path);;
}
d->path = path;
emit pathChanged();
// re-connect the signal
connect(d->subscriber, SIGNAL(contentsChanged()),
this, SIGNAL(contentsChanged()));
}
QString QDeclarativeValueSpaceSubscriber::path() const
{
return d->path;
}
/*!
\qmlproperty QVariant ValueSpaceSubscriber::value
\since Mobility 1.2
This property holds the value of the key at the set path in the Value Space.
Read-only.
*/
QVariant QDeclarativeValueSpaceSubscriber::value(const QString &subPath, const QVariant &def) const
{
if (!d->subscriber)
return QVariant();
return d->subscriber->value(subPath, def);
}
/*!
\qmlproperty QStringList ValueSpaceSubscriber::subPaths
\since Mobility 1.2
This property holds a list of known sub-paths of the currently set path.
*/
QStringList QDeclarativeValueSpaceSubscriber::subPaths() const
{
if (!d->subscriber)
return QStringList();
return d->subscriber->subPaths();
}
/*!
\qmlproperty bool ValueSpaceSubscriber::connected
\since Mobility 1.2
This property holds whether the subscriber is currently connected to the
backing store of the Value Space.
*/
bool QDeclarativeValueSpaceSubscriber::isConnected() const
{
if (!d->subscriber)
return false;
return d->subscriber->isConnected();
}
|
