Home · All Namespaces · All Classes · Main Classes · Grouped Classes · Modules · Functions

QMacPasteboardMime Class Reference
[QtGui module]

The QMacPasteboardMime class maps open-standard MIME to Mac flavors. More...

 #include <QMacPasteboardMime>

This class was introduced in Qt 4.2.

• List of all members, including inherited members

Public Functions

• QMacPasteboardMime ( char t )
• virtual ~QMacPasteboardMime ()
• virtual bool canConvert ( const QString & mime, QString flav ) = 0
• virtual QList<QByteArray> convertFromMime ( const QString & mime, QVariant data, QString flav ) = 0
• virtual QVariant convertToMime ( const QString & mime, QList<QByteArray> data, QString flav ) = 0
• virtual QString convertorName () = 0
• virtual QString flavorFor ( const QString & mime ) = 0
• virtual QString mimeFor ( QString flav ) = 0

Static Public Members

• QList<QMacPasteboardMime *> all ( uchar t )
• QMacPasteboardMime * convertor ( uchar t, const QString & mime, QString flav )
• QString flavorToMime ( uchar t, QString flav )

Related Non-Members

• void qRegisterDraggedTypes ( const QStringList & types )

Detailed Description

The QMacPasteboardMime class maps open-standard MIME to Mac flavors.

Qt's drag and drop support and clipboard facilities use the MIME standard. On X11, this maps trivially to the Xdnd protocol, but on Mac although some applications use MIME types to describe clipboard formats, others use arbitrary non-standardized naming conventions, or unnamed built-in Mac formats.

By instantiating subclasses of QMacPasteboardMime that provide conversions between Mac flavors and MIME formats, you can convert proprietary clipboard formats to MIME formats.

Qt has predefined support for the following Mac flavors:

• kScrapFlavorTypeUnicode - converted to "text/plain;charset=ISO-10646-UCS-2"
• kScrapFlavorTypeText - converted to "text/plain;charset=system" or "text/plain"
• kScrapFlavorTypePicture - converted to "application/x-qt-image"
• typeFileURL - converted to "text/uri-list"

You can check if a MIME type is convertible using canConvert() and can perform conversions with convertToMime() and convertFromMime().

Member Function Documentation

QMacPasteboardMime::QMacPasteboardMime ( char t )

Constructs a new conversion object of type t, adding it to the globally accessed list of available convertors.

QMacPasteboardMime::~QMacPasteboardMime ()   [virtual]

Destroys a conversion object, removing it from the global list of available convertors.

QList<QMacPasteboardMime *> QMacPasteboardMime::all ( uchar t )   [static]

Returns a list of all currently defined QMacPasteboardMime objects of type t.

bool QMacPasteboardMime::canConvert ( const QString & mime, QString flav )   [pure virtual]

Returns true if the convertor can convert (both ways) between mime and flav; otherwise returns false.

All subclasses must reimplement this pure virtual function.

QList<QByteArray> QMacPasteboardMime::convertFromMime ( const QString & mime, QVariant data, QString flav )   [pure virtual]

Returns data converted from MIME type mime to Mac UTI flav.

Note that Mac flavors must all be self-terminating. The return value may contain trailing data.

All subclasses must reimplement this pure virtual function.

QVariant QMacPasteboardMime::convertToMime ( const QString & mime, QList<QByteArray> data, QString flav )   [pure virtual]

Returns data converted from Mac UTI flav to MIME type mime.

Note that Mac flavors must all be self-terminating. The input data may contain trailing data.

All subclasses must reimplement this pure virtual function.

QMacPasteboardMime * QMacPasteboardMime::convertor ( uchar t, const QString & mime, QString flav )   [static]

Returns the most-recently created QMacPasteboardMime of type t that can convert between the mime and flav formats. Returns 0 if no such convertor exists.

QString QMacPasteboardMime::convertorName ()   [pure virtual]

Returns a name for the convertor.

All subclasses must reimplement this pure virtual function.

QString QMacPasteboardMime::flavorFor ( const QString & mime )   [pure virtual]

Returns the Mac UTI used for MIME type mime, or 0 if this convertor does not support mime.

All subclasses must reimplement this pure virtual function.

QString QMacPasteboardMime::flavorToMime ( uchar t, QString flav )   [static]

Returns a MIME type of type t for flav, or 0 if none exists.

QString QMacPasteboardMime::mimeFor ( QString flav )   [pure virtual]

Returns the MIME UTI used for Mac flavor flav, or 0 if this convertor does not support flav.

All subclasses must reimplement this pure virtual function.

Related Non-Members

void qRegisterDraggedTypes ( const QStringList & types )

Registers the given types as custom pasteboard types.

This function should be called to enable the Drag and Drop events for custom pasteboard types on Cocoa implementations. This is required in addition to a QMacPasteboardMime subclass implementation. By default drag and drop is enabled for all standard pasteboard types.

See also QMacPasteboardMime.