1/****************************************************************************
2**
3** Copyright (C) 2014 Digia Plc and/or its subsidiary(-ies).
4** Contact: http://www.qt-project.org/legal
5**
6** This file is part of the QtGui module of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL$
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 Digia. For licensing terms and
14** conditions see http://qt.digia.com/licensing. For further information
15** use the contact form at http://qt.digia.com/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 as published by the Free Software
20** Foundation and appearing in the file LICENSE.LGPL included in the
21** packaging of this file. Please review the following information to
22** ensure the GNU Lesser General Public License version 2.1 requirements
23** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
24**
25** In addition, as a special exception, Digia gives you certain additional
26** rights. These rights are described in the Digia Qt LGPL Exception
27** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
28**
29** GNU General Public License Usage
30** Alternatively, this file may be used under the terms of the GNU
31** General Public License version 3.0 as published by the Free Software
32** Foundation and appearing in the file LICENSE.GPL included in the
33** packaging of this file. Please review the following information to
34** ensure the GNU General Public License version 3.0 requirements will be
35** met: http://www.gnu.org/copyleft/gpl.html.
36**
37**
38** $QT_END_LICENSE$
39**
40****************************************************************************/
41
42#ifndef QMIME_H
43#define QMIME_H
44
45#include <QtCore/qmimedata.h>
46
47QT_BEGIN_HEADER
48
49QT_BEGIN_NAMESPACE
50
51QT_MODULE(Gui)
52
53class Q_GUI_EXPORT QMimeSource
54{
55public:
56 virtual ~QMimeSource();
57 virtual const char* format(int n = 0) const = 0;
58 virtual bool provides(const char*) const;
59 virtual QByteArray encodedData(const char*) const = 0;
60};
61
62
63#if defined(Q_WS_WIN)
64
65QT_BEGIN_INCLUDE_NAMESPACE
66typedef struct tagFORMATETC FORMATETC;
67typedef struct tagSTGMEDIUM STGMEDIUM;
68struct IDataObject;
69
70#include <QtCore/qvariant.h>
71QT_END_INCLUDE_NAMESPACE
72
73/*
74 Encapsulation of conversion between MIME and Windows CLIPFORMAT.
75 Not need on X11, as the underlying protocol uses the MIME standard
76 directly.
77*/
78
79class Q_GUI_EXPORT QWindowsMime
80{
81public:
82 QWindowsMime();
83 virtual ~QWindowsMime();
84
85 // for converting from Qt
86 virtual bool canConvertFromMime(const FORMATETC &formatetc, const QMimeData *mimeData) const = 0;
87 virtual bool convertFromMime(const FORMATETC &formatetc, const QMimeData *mimeData, STGMEDIUM * pmedium) const = 0;
88 virtual QVector<FORMATETC> formatsForMime(const QString &mimeType, const QMimeData *mimeData) const = 0;
89
90 // for converting to Qt
91 virtual bool canConvertToMime(const QString &mimeType, IDataObject *pDataObj) const = 0;
92 virtual QVariant convertToMime(const QString &mimeType, IDataObject *pDataObj, QVariant::Type preferredType) const = 0;
93 virtual QString mimeForFormat(const FORMATETC &formatetc) const = 0;
94
95 static int registerMimeType(const QString &mime);
96
97private:
98 friend class QClipboardWatcher;
99 friend class QDragManager;
100 friend class QDropData;
101 friend class QOleDataObject;
102
103 static QWindowsMime *converterToMime(const QString &mimeType, IDataObject *pDataObj);
104 static QStringList allMimesForFormats(IDataObject *pDataObj);
105 static QWindowsMime *converterFromMime(const FORMATETC &formatetc, const QMimeData *mimeData);
106 static QVector<FORMATETC> allFormatsForMime(const QMimeData *mimeData);
107};
108
109#endif
110#if defined(Q_WS_MAC)
111
112/*
113 Encapsulation of conversion between MIME and Mac flavor.
114 Not needed on X11, as the underlying protocol uses the MIME standard
115 directly.
116*/
117
118class Q_GUI_EXPORT QMacMime { //Obsolete
119 char type;
120public:
121 enum QMacMimeType { MIME_DND=0x01, MIME_CLIP=0x02, MIME_QT_CONVERTOR=0x04, MIME_ALL=MIME_DND|MIME_CLIP };
122 explicit QMacMime(char) { Q_UNUSED(type); }
123 virtual ~QMacMime() { }
124
125 static void initialize() { }
126
127 static QList<QMacMime*> all(QMacMimeType) { return QList<QMacMime*>(); }
128 static QMacMime *convertor(QMacMimeType, const QString &, int) { return 0; }
129 static QString flavorToMime(QMacMimeType, int) { return QString(); }
130
131 virtual QString convertorName()=0;
132 virtual int countFlavors()=0;
133 virtual int flavor(int index)=0;
134 virtual bool canConvert(const QString &mime, int flav)=0;
135 virtual QString mimeFor(int flav)=0;
136 virtual int flavorFor(const QString &mime)=0;
137 virtual QVariant convertToMime(const QString &mime, QList<QByteArray> data, int flav)=0;
138 virtual QList<QByteArray> convertFromMime(const QString &mime, QVariant data, int flav)=0;
139};
140
141class Q_GUI_EXPORT QMacPasteboardMime {
142 char type;
143public:
144 enum QMacPasteboardMimeType { MIME_DND=0x01,
145 MIME_CLIP=0x02,
146 MIME_QT_CONVERTOR=0x04,
147 MIME_QT3_CONVERTOR=0x08,
148 MIME_ALL=MIME_DND|MIME_CLIP
149 };
150 explicit QMacPasteboardMime(char);
151 virtual ~QMacPasteboardMime();
152
153 static void initialize();
154
155 static QList<QMacPasteboardMime*> all(uchar);
156 static QMacPasteboardMime *convertor(uchar, const QString &mime, QString flav);
157 static QString flavorToMime(uchar, QString flav);
158
159 virtual QString convertorName() = 0;
160
161 virtual bool canConvert(const QString &mime, QString flav) = 0;
162 virtual QString mimeFor(QString flav) = 0;
163 virtual QString flavorFor(const QString &mime) = 0;
164 virtual QVariant convertToMime(const QString &mime, QList<QByteArray> data, QString flav) = 0;
165 virtual QList<QByteArray> convertFromMime(const QString &mime, QVariant data, QString flav) = 0;
166};
167
168// ### Qt 5: Add const QStringList& QMacPasteboardMime::supportedFlavours()
169Q_GUI_EXPORT void qRegisterDraggedTypes(const QStringList &types);
170#endif // Q_WS_MAC
171
172QT_END_NAMESPACE
173
174QT_END_HEADER
175
176#endif // QMIME_H
177