qmime.h
This is the verbatim text of the qmime.h include file. It is provided only for illustration; the copyright remains with Trolltech.
/****************************************************************************
** $Id: qt/qmime.h 3.3.8 edited Jan 11 14:46 $
**
** Definition of mime classes
**
** Created : 981204
**
** Copyright (C) 1998-2007 Trolltech ASA. All rights reserved.
**
** This file is part of the kernel module of the Qt GUI Toolkit.
**
** This file may be used under the terms of the GNU General Public
** License versions 2.0 or 3.0 as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL included in the
** packaging of this file. Alternatively you may (at your option) use any
** later version of the GNU General Public License if such license has
** been publicly approved by Trolltech ASA (or its successors, if any)
** and the KDE Free Qt Foundation.
**
** Please review the following information to ensure GNU General
** Public Licensing requirements will be met:
** http://trolltech.com/products/qt/licenses/licensing/opensource/.
** If you are unsure which license is appropriate for your use, please
** review the following information:
** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
** or contact the sales department at sales@trolltech.com.
**
** This file may be used under the terms of the Q Public License as
** defined by Trolltech ASA and appearing in the file LICENSE.QPL
** included in the packaging of this file. Licensees holding valid Qt
** Commercial licenses may use this file in accordance with the Qt
** Commercial License Agreement provided with the Software.
**
** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
** herein.
**
**********************************************************************/
#ifndef QMIME_H
#define QMIME_H
#ifndef QT_H
#include "qwindowdefs.h"
#include "qmap.h"
#endif // QT_H
#ifndef QT_NO_MIME
class QImageDrag;
class QTextDrag;
class Q_EXPORT QMimeSource
{
friend class QClipboardData;
public:
QMimeSource();
virtual ~QMimeSource();
virtual const char* format( int n = 0 ) const = 0;
virtual bool provides( const char* ) const;
virtual QByteArray encodedData( const char* ) const = 0;
int serialNumber() const;
private:
int ser_no;
enum { NoCache, Text, Graphics } cacheType;
union
{
struct
{
QString *str;
QCString *subtype;
} txt;
struct
{
QImage *img;
QPixmap *pix;
} gfx;
} cache;
void clearCache();
// friends for caching
friend class QImageDrag;
friend class QTextDrag;
};
inline int QMimeSource::serialNumber() const
{ return ser_no; }
class QStringList;
class QMimeSourceFactoryData;
class Q_EXPORT QMimeSourceFactory {
public:
QMimeSourceFactory();
virtual ~QMimeSourceFactory();
static QMimeSourceFactory* defaultFactory();
static void setDefaultFactory( QMimeSourceFactory* );
static QMimeSourceFactory* takeDefaultFactory();
static void addFactory( QMimeSourceFactory *f );
static void removeFactory( QMimeSourceFactory *f );
virtual const QMimeSource* data(const QString& abs_name) const;
virtual QString makeAbsolute(const QString& abs_or_rel_name, const QString& context) const;
const QMimeSource* data(const QString& abs_or_rel_name, const QString& context) const;
virtual void setText( const QString& abs_name, const QString& text );
virtual void setImage( const QString& abs_name, const QImage& im );
virtual void setPixmap( const QString& abs_name, const QPixmap& pm );
virtual void setData( const QString& abs_name, QMimeSource* data );
virtual void setFilePath( const QStringList& );
virtual QStringList filePath() const;
void addFilePath( const QString& );
virtual void setExtensionType( const QString& ext, const char* mimetype );
private:
QMimeSource *dataInternal(const QString& abs_name, const QMap<QString, QString> &extensions ) const;
QMimeSourceFactoryData* d;
};
#if defined(Q_WS_WIN)
#ifndef QT_H
#include "qptrlist.h" // down here for GCC 2.7.* compatibility
#endif // QT_H
/*
Encapsulation of conversion between MIME and Windows CLIPFORMAT.
Not need on X11, as the underlying protocol uses the MIME standard
directly.
*/
class Q_EXPORT QWindowsMime {
public:
QWindowsMime();
virtual ~QWindowsMime();
static void initialize();
static QPtrList<QWindowsMime> all();
static QWindowsMime* convertor( const char* mime, int cf );
static const char* cfToMime(int cf);
static int registerMimeType(const char *mime);
virtual const char* convertorName()=0;
virtual int countCf()=0;
virtual int cf(int index)=0;
virtual bool canConvert( const char* mime, int cf )=0;
virtual const char* mimeFor(int cf)=0;
virtual int cfFor(const char* )=0;
virtual QByteArray convertToMime( QByteArray data, const char* mime, int cf )=0;
virtual QByteArray convertFromMime( QByteArray data, const char* mime, int cf )=0;
};
#endif
#if defined(Q_WS_MAC)
#ifndef QT_H
#include "qptrlist.h" // down here for GCC 2.7.* compatibility
#endif // QT_H
/*
Encapsulation of conversion between MIME and Mac flavor.
Not need on X11, as the underlying protocol uses the MIME standard
directly.
*/
class Q_EXPORT QMacMime {
char type;
public:
enum QMacMimeType { MIME_DND=0x01, MIME_CLIP=0x02, MIME_QT_CONVERTOR=0x04, MIME_ALL=MIME_DND|MIME_CLIP };
QMacMime(char);
virtual ~QMacMime();
static void initialize();
static QPtrList<QMacMime> all(QMacMimeType);
static QMacMime* convertor(QMacMimeType, const char* mime, int flav);
static const char* flavorToMime(QMacMimeType, int flav);
virtual const char* convertorName()=0;
virtual int countFlavors()=0;
virtual int flavor(int index)=0;
virtual bool canConvert(const char* mime, int flav)=0;
virtual const char* mimeFor(int flav)=0;
virtual int flavorFor(const char*)=0;
virtual QByteArray convertToMime(QValueList<QByteArray> data, const char* mime, int flav)=0;
virtual QValueList<QByteArray> convertFromMime(QByteArray data, const char* mime, int flav)=0;
};
#endif // Q_WS_MAC
#endif // QT_NO_MIME
#endif // QMIME_H
