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 QCLIPBOARD_H
43#define QCLIPBOARD_H
44
45#include <QtCore/qobject.h>
46
47QT_BEGIN_HEADER
48
49QT_BEGIN_NAMESPACE
50
51QT_MODULE(Gui)
52
53#ifndef QT_NO_CLIPBOARD
54
55class QMimeSource;
56class QMimeData;
57class QImage;
58class QPixmap;
59
60class QClipboardPrivate;
61
62class Q_GUI_EXPORT QClipboard : public QObject
63{
64 Q_OBJECT
65 Q_DECLARE_PRIVATE(QClipboard)
66private:
67 QClipboard(QObject *parent);
68 ~QClipboard();
69
70public:
71 enum Mode { Clipboard, Selection, FindBuffer, LastMode = FindBuffer };
72
73 void clear(Mode mode = Clipboard);
74
75 bool supportsSelection() const;
76 bool supportsFindBuffer() const;
77
78 bool ownsSelection() const;
79 bool ownsClipboard() const;
80 bool ownsFindBuffer() const;
81
82 QString text(Mode mode = Clipboard) const;
83 QString text(QString& subtype, Mode mode = Clipboard) const;
84 void setText(const QString &, Mode mode = Clipboard);
85
86#ifdef QT3_SUPPORT
87 QT3_SUPPORT QMimeSource *data(Mode mode = Clipboard) const;
88 QT3_SUPPORT void setData(QMimeSource*, Mode mode = Clipboard);
89#endif
90 const QMimeData *mimeData(Mode mode = Clipboard ) const;
91 void setMimeData(QMimeData *data, Mode mode = Clipboard);
92
93 QImage image(Mode mode = Clipboard) const;
94 QPixmap pixmap(Mode mode = Clipboard) const;
95 void setImage(const QImage &, Mode mode = Clipboard);
96 void setPixmap(const QPixmap &, Mode mode = Clipboard);
97
98Q_SIGNALS:
99 void changed(QClipboard::Mode mode);
100 void selectionChanged();
101 void findBufferChanged();
102 void dataChanged();
103private Q_SLOTS:
104 void ownerDestroyed();
105
106protected:
107 void connectNotify(const char *);
108 bool event(QEvent *);
109
110 friend class QApplication;
111 friend class QApplicationPrivate;
112 friend class QBaseApplication;
113 friend class QDragManager;
114 friend class QMimeSource;
115 friend class QPlatformClipboard;
116
117private:
118 Q_DISABLE_COPY(QClipboard)
119
120 bool supportsMode(Mode mode) const;
121 bool ownsMode(Mode mode) const;
122 void emitChanged(Mode mode);
123};
124
125#endif // QT_NO_CLIPBOARD
126
127QT_END_NAMESPACE
128
129QT_END_HEADER
130
131#endif // QCLIPBOARD_H
132