1/****************************************************************************
2**
3** Copyright (C) 2015 The Qt Company Ltd.
4** Contact: http://www.qt.io/licensing/
5**
6** This file is part of the QtContacts module of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL21$
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 2.1 or version 3 as published by the Free
20** Software Foundation and appearing in the file LICENSE.LGPLv21 and
21** LICENSE.LGPLv3 included in the packaging of this file. Please review the
22** following information to ensure the GNU Lesser General Public License
23** requirements will be met: https://www.gnu.org/licenses/lgpl.html and
24** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
25**
26** As a special exception, The Qt Company gives you certain additional
27** rights. These rights are described in The Qt Company LGPL Exception
28** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
29**
30** $QT_END_LICENSE$
31**
32****************************************************************************/
33
34#ifndef QCONTACTFETCHHINT_H
35#define QCONTACTFETCHHINT_H
36
37#include <QtCore/qshareddata.h>
38#include <QtCore/qsize.h>
39#include <QtCore/qstringlist.h>
40
41#include <QtContacts/qcontactdetail.h>
42
43QT_BEGIN_NAMESPACE_CONTACTS
44
45class QContactFetchHintPrivate;
46class Q_CONTACTS_EXPORT QContactFetchHint {
47public:
48 QContactFetchHint();
49 QContactFetchHint(const QContactFetchHint& other);
50 ~QContactFetchHint();
51 QContactFetchHint& operator=(const QContactFetchHint& other);
52
53 QList<QContactDetail::DetailType> detailTypesHint() const;
54 void setDetailTypesHint(const QList<QContactDetail::DetailType> &types);
55
56 QStringList relationshipTypesHint() const;
57 void setRelationshipTypesHint(const QStringList& relationshipTypes);
58
59 QSize preferredImageSize() const;
60 void setPreferredImageSize(const QSize& size);
61
62 enum OptimizationHint {
63 AllRequired = 0x0,
64 NoRelationships = 0x1,
65 NoActionPreferences = 0x2,
66 NoBinaryBlobs = 0x4
67 // any other optimization hints?
68 };
69 Q_DECLARE_FLAGS(OptimizationHints, OptimizationHint)
70
71 OptimizationHints optimizationHints() const;
72 void setOptimizationHints(OptimizationHints hints);
73
74 int maxCountHint() const;
75 void setMaxCountHint(int count);
76
77private:
78 QSharedDataPointer<QContactFetchHintPrivate> d;
79};
80
81#ifndef QT_NO_DATASTREAM
82Q_CONTACTS_EXPORT QDataStream& operator<<(QDataStream& out, const QContactFetchHint& hint);
83Q_CONTACTS_EXPORT QDataStream& operator>>(QDataStream& in, QContactFetchHint& hint);
84#endif
85
86#ifndef QT_NO_DEBUG_STREAM
87Q_CONTACTS_EXPORT QDebug operator<<(QDebug dbg, const QContactFetchHint& hint);
88#endif
89
90Q_DECLARE_OPERATORS_FOR_FLAGS(QContactFetchHint::OptimizationHints)
91
92QT_END_NAMESPACE_CONTACTS
93
94#endif // QCONTACTFETCHHINT_H
95

source code of qtpim/src/contacts/qcontactfetchhint.h