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
|
/****************************************************************************
**
** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies).
** Contact: http://www.qt-project.org/legal
**
** This file is part of the Qt Mobility Components.
**
** $QT_BEGIN_LICENSE:LGPL$
** 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 Lesser General Public License Usage
** Alternatively, 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, Digia gives you certain additional
** rights. These rights are described in the Digia 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.
**
**
** $QT_END_LICENSE$
**
****************************************************************************/
#include "xqsettingsmanager_p.h"
#include <QVariant>
/*
\class XQSettingsManager
\internal
\brief The XQSettingsManager class provides methods to handle settings items.
The settings items can be targetted in Central Repository or Publish And Subscribe.
*/
/*
Constructs an XQSettingsManager object with the given parent.
*/
XQSettingsManager::XQSettingsManager(QObject* parent)
: QObject(parent), d(new XQSettingsManagerPrivate(this))
{
}
/*
Destroys the XQSettingsManager object.
*/
XQSettingsManager::~XQSettingsManager()
{
delete d;
}
/*
\enum XQSettingsManager::Type
This enum defines the possible item types for an XQSettingsKey object.
*/
/* \var XQSettingsManager::TypeVariant XQSettingsManager::TypeVariant
The item type is detected automatically.
*/
/* \var XQSettingsManager::TypeInt XQSettingsManager::TypeInt
The item is treated as integer.
*/
/* \var XQSettingsManager::TypeDouble XQSettingsManager::TypeDouble
The item is treated as double. NOTE: This is not supported in Publish And Subscribe.
*/
/* \var XQSettingsManager::TypeString XQSettingsManager::TypeString
The item is treated as string.
*/
/* \var XQSettingsManager::TypeByteArray XQSettingsManager::TypeByteArray
The item is treated as bytearray.
*/
/*!
\enum XQSettingsManager::Error
This enum defines the possible errors for an XQSettingsManager object.
*/
/* \var XQSettingsManager::Error XQSettingsManager::NoError
No error occurred.
*/
/* \var XQSettingsManager::Error XQSettingsManager::OutOfMemoryError
Not enough memory.
*/
/* \var XQSettingsManager::Error XQSettingsManager::NotFoundError
Item not found error.
*/
/* \var XQSettingsManager::Error XQSettingsManager::AlreadyExistsError
Item already exists error.
*/
/* \var XQSettingsManager::Error XQSettingsManager::NotSupportedError
Operation with this kind of item type isn't supported error.
*/
/* \var XQSettingsManager::Error XQSettingsManager::PermissionDeniedError
Permission denied.
*/
/* \var XQSettingsManager::Error XQSettingsManager::UnknownError
Unknown error.
*/
/*
Reads an item value.
\param key XQSettingsKey where the value is read from
\param type Value type. Default is TypeVariant which means that the type is
tried to detect automatically.
\return Settings value as QVariant or null object if an error has occurred.
\sa error(), writeItemValue()
*/
QVariant XQSettingsManager::readItemValue(const XQSettingsKey& key, XQSettingsManager::Type type)
{
return d->readItemValue(key, type);
}
/*
Writes an item value.
\param key XQSettingsKey where the value is written to
\param value Value to be written into the settings item. The type is determined with
QVariant.type() and it must be either QVariant::Int, QVariant::Double, QVariant::String or
QVariant::ByteArray.
\return True if the item was written successfully, otherwise return false.
\sa error(), readItemValue()
*/
bool XQSettingsManager::writeItemValue(const XQSettingsKey& key, const QVariant& value)
{
return d->writeItemValue(key, value);
}
/*
Starts monitoring a settings item.
\param key XQSettingsKey of which changes are monitored.
\param type Value type. Default is TypeVariant which means that the type is
tried to detect automatically.
\return True if monitoring was started successfully, otherwise return false.
\sa error(), stopMonitoring()
*/
bool XQSettingsManager::startMonitoring(const XQSettingsKey& key, XQSettingsManager::Type type)
{
return d->startMonitoring(key, type);
}
/*
Stops monitoring a settings item.
\param key XQSettingsKey of which changes are not monitored any more.
\return True if monitoring was stopped successfully, otherwise return false.
\sa error(), startMonitoring()
*/
bool XQSettingsManager::stopMonitoring(const XQSettingsKey& key)
{
return d->stopMonitoring(key);
}
/*
Returns the type of error that occurred if the latest function call failed.
Otherwise it returns NoError
\return Error code
*/
XQSettingsManager::Error XQSettingsManager::error() const
{
return d->error();
}
|
