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 QCONTACTACTIONFACTORY_H
35#define QCONTACTACTIONFACTORY_H
36
37#include <QtCore/qlist.h>
38#include <QtCore/qmap.h>
39#include <QtCore/qobject.h>
40#include <QtCore/qset.h>
41#include <QtCore/qvariant.h>
42
43#include <QtContacts/qcontactactiontarget.h>
44#include <QtContacts/qcontactactiondescriptor.h>
45
46QT_BEGIN_NAMESPACE_CONTACTS
47
48class QContact;
49class QContactAction;
50class QContactFilter;
51
52class Q_CONTACTS_EXPORT QContactActionFactory : public QObject
53{
54 Q_OBJECT
55
56public:
57 QContactActionFactory(QObject *parent_ = Q_NULLPTR) : QObject(parent_) {}
58 virtual ~QContactActionFactory();
59 virtual QList<QContactActionDescriptor> actionDescriptors() const = 0;
60 virtual QContactAction* create(const QContactActionDescriptor& which) const = 0;
61
62 // Backend functionality for QCAD
63 virtual QSet<QContactActionTarget> supportedTargets(const QContact& contact, const QContactActionDescriptor& which) const = 0;
64 virtual QContactFilter contactFilter(const QContactActionDescriptor& which) const = 0;
65 virtual QVariant metaData(const QString& key, const QList<QContactActionTarget>& targets, const QVariantMap& parameters, const QContactActionDescriptor& which) const = 0;
66
67 virtual bool supportsContact(const QContact& contact, const QContactActionDescriptor& which) const; // virtual but not pure virtual; default impl. calls supportedTargets.isEmpty().
68
69 inline static const QString InterfaceName() {return QStringLiteral("org.qt-project.Qt.QContactActionFactory");};
70
71protected:
72 QContactActionDescriptor createDescriptor(const QString& actionName, const QString& serviceName, const QString& actionIdentifier, int implementationVersion) const;
73};
74
75QT_END_NAMESPACE_CONTACTS
76
77#endif // QCONTACTACTIONFACTORY_H
78

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