qmime.h
上传用户:detong
上传日期:2022-06-22
资源大小:20675k
文件大小:6k
源码类别:

系统编程

开发平台:

Unix_Linux

  1. /****************************************************************************
  2. **
  3. ** Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies).
  4. ** Contact: Qt Software Information (qt-info@nokia.com)
  5. **
  6. ** This file is part of the QtGui module of the Qt Toolkit.
  7. **
  8. ** Commercial Usage
  9. ** Licensees holding valid Qt Commercial licenses may use this file in
  10. ** accordance with the Qt Commercial License Agreement provided with the
  11. ** Software or, alternatively, in accordance with the terms contained in
  12. ** a written agreement between you and Nokia.
  13. **
  14. **
  15. ** GNU General Public License Usage
  16. ** Alternatively, this file may be used under the terms of the GNU
  17. ** General Public License versions 2.0 or 3.0 as published by the Free
  18. ** Software Foundation and appearing in the file LICENSE.GPL included in
  19. ** the packaging of this file.  Please review the following information
  20. ** to ensure GNU General Public Licensing requirements will be met:
  21. ** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
  22. ** http://www.gnu.org/copyleft/gpl.html.  In addition, as a special
  23. ** exception, Nokia gives you certain additional rights. These rights
  24. ** are described in the Nokia Qt GPL Exception version 1.3, included in
  25. ** the file GPL_EXCEPTION.txt in this package.
  26. **
  27. ** Qt for Windows(R) Licensees
  28. ** As a special exception, Nokia, as the sole copyright holder for Qt
  29. ** Designer, grants users of the Qt/Eclipse Integration plug-in the
  30. ** right for the Qt/Eclipse Integration to link to functionality
  31. ** provided by Qt Designer and its related libraries.
  32. **
  33. ** If you are unsure which license is appropriate for your use, please
  34. ** contact the sales department at qt-sales@nokia.com.
  35. **
  36. ****************************************************************************/
  37. #ifndef QMIME_H
  38. #define QMIME_H
  39. #include <QtCore/qmimedata.h>
  40. QT_BEGIN_HEADER
  41. QT_BEGIN_NAMESPACE
  42. QT_MODULE(Gui)
  43. class Q_GUI_EXPORT QMimeSource
  44. {
  45. public:
  46.     virtual ~QMimeSource();
  47.     virtual const char* format(int n = 0) const = 0;
  48.     virtual bool provides(const char*) const;
  49.     virtual QByteArray encodedData(const char*) const = 0;
  50. };
  51. #if defined(Q_WS_WIN)
  52. QT_BEGIN_INCLUDE_NAMESPACE
  53. typedef struct tagFORMATETC FORMATETC;
  54. typedef struct tagSTGMEDIUM STGMEDIUM;
  55. struct IDataObject;
  56. #include <QtCore/qvariant.h>
  57. QT_END_INCLUDE_NAMESPACE
  58. /*
  59.   Encapsulation of conversion between MIME and Windows CLIPFORMAT.
  60.   Not need on X11, as the underlying protocol uses the MIME standard
  61.   directly.
  62. */
  63. class Q_GUI_EXPORT QWindowsMime
  64. {
  65. public:
  66.     QWindowsMime();
  67.     virtual ~QWindowsMime();
  68.     // for converting from Qt
  69.     virtual bool canConvertFromMime(const FORMATETC &formatetc, const QMimeData *mimeData) const = 0;
  70.     virtual bool convertFromMime(const FORMATETC &formatetc, const QMimeData *mimeData, STGMEDIUM * pmedium) const = 0;
  71.     virtual QVector<FORMATETC> formatsForMime(const QString &mimeType, const QMimeData *mimeData) const = 0;
  72.     // for converting to Qt
  73.     virtual bool canConvertToMime(const QString &mimeType, IDataObject *pDataObj) const = 0;
  74.     virtual QVariant convertToMime(const QString &mimeType, IDataObject *pDataObj, QVariant::Type preferredType) const = 0;
  75.     virtual QString mimeForFormat(const FORMATETC &formatetc) const = 0;
  76.     static int registerMimeType(const QString &mime);
  77. private:
  78.     friend class QClipboardWatcher;
  79.     friend class QDragManager;
  80.     friend class QDropData;
  81.     friend class QOleDataObject;
  82.     static QWindowsMime *converterToMime(const QString &mimeType, IDataObject *pDataObj);
  83.     static QStringList allMimesForFormats(IDataObject *pDataObj);
  84.     static QWindowsMime *converterFromMime(const FORMATETC &formatetc, const QMimeData *mimeData);
  85.     static QVector<FORMATETC> allFormatsForMime(const QMimeData *mimeData);
  86. };
  87. #endif
  88. #if defined(Q_WS_MAC)
  89. /*
  90.   Encapsulation of conversion between MIME and Mac flavor.
  91.   Not needed on X11, as the underlying protocol uses the MIME standard
  92.   directly.
  93. */
  94. class Q_GUI_EXPORT QMacMime { //Obsolete
  95.     char type;
  96. public:
  97.     enum QMacMimeType { MIME_DND=0x01, MIME_CLIP=0x02, MIME_QT_CONVERTOR=0x04, MIME_ALL=MIME_DND|MIME_CLIP };
  98.     explicit QMacMime(char) { }
  99.     virtual ~QMacMime() { }
  100.     static void initialize() { }
  101.     static QList<QMacMime*> all(QMacMimeType) { return QList<QMacMime*>(); }
  102.     static QMacMime *convertor(QMacMimeType, const QString &, int) { return 0; }
  103.     static QString flavorToMime(QMacMimeType, int) { return QString(); }
  104.     virtual QString convertorName()=0;
  105.     virtual int countFlavors()=0;
  106.     virtual int flavor(int index)=0;
  107.     virtual bool canConvert(const QString &mime, int flav)=0;
  108.     virtual QString mimeFor(int flav)=0;
  109.     virtual int flavorFor(const QString &mime)=0;
  110.     virtual QVariant convertToMime(const QString &mime, QList<QByteArray> data, int flav)=0;
  111.     virtual QList<QByteArray> convertFromMime(const QString &mime, QVariant data, int flav)=0;
  112. };
  113. class Q_GUI_EXPORT QMacPasteboardMime {
  114.     char type;
  115. public:
  116.     enum QMacPasteboardMimeType { MIME_DND=0x01,
  117.                                   MIME_CLIP=0x02,
  118.                                   MIME_QT_CONVERTOR=0x04,
  119.                                   MIME_QT3_CONVERTOR=0x08,
  120.                                   MIME_ALL=MIME_DND|MIME_CLIP
  121.     };
  122.     explicit QMacPasteboardMime(char);
  123.     virtual ~QMacPasteboardMime();
  124.     static void initialize();
  125.     static QList<QMacPasteboardMime*> all(uchar);
  126.     static QMacPasteboardMime *convertor(uchar, const QString &mime, QString flav);
  127.     static QString flavorToMime(uchar, QString flav);
  128.     virtual QString convertorName() = 0;
  129.     virtual bool canConvert(const QString &mime, QString flav) = 0;
  130.     virtual QString mimeFor(QString flav) = 0;
  131.     virtual QString flavorFor(const QString &mime) = 0;
  132.     virtual QVariant convertToMime(const QString &mime, QList<QByteArray> data, QString flav) = 0;
  133.     virtual QList<QByteArray> convertFromMime(const QString &mime, QVariant data, QString flav) = 0;
  134. };
  135. #endif // Q_WS_MAC
  136. QT_END_NAMESPACE
  137. QT_END_HEADER
  138. #endif // QMIME_H