QMacMime(3qt)

NAME¶

QMacMime - Maps open-standard MIME to Mac flavors

SYNOPSIS¶

#include <qmime.h>

Public Members¶

QMacMime ( char t )
virtual ~QMacMime ()
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 * mime ) = 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

Static Public Members¶

QPtrList<QMacMime> all ( QMacMimeType t )
QMacMime * convertor ( QMacMimeType t, const char * mime, int flav )
const char * flavorToMime ( QMacMimeType t, int flav )

DESCRIPTION¶

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

Qt's drag-and-drop 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 QMacMime 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" and supported by QTextDrag.
kScrapFlavorTypeText - converted to "text/plain;charset=system" or "text/plain" and supported by QTextDrag.
kScrapFlavorTypePicture - converted to "image/format", where format is a Qt image format, and supported by QImageDrag.
kDragFlavorTypeHFS - converted to "text/uri-list", and supported by QUriDrag.

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

See also Drag And Drop Classes, Input/Output and Networking, and Miscellaneous Classes.

MEMBER FUNCTION DOCUMENTATION¶

QMacMime::QMacMime ( char t )¶

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

QMacMime::~QMacMime () [virtual]¶

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

QPtrList<QMacMime> QMacMime::all ( QMacMimeType t ) [static]¶

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

bool QMacMime::canConvert ( const char * mime, int flav ) [pure virtual]¶

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