QWindowsMime(3qt)

NAME¶

QWindowsMime - Maps open-standard MIME to Window Clipboard formats

SYNOPSIS¶

#include <qmime.h>

Public Members¶

QWindowsMime ()
virtual ~QWindowsMime ()
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 * mime ) = 0
virtual QByteArray convertToMime ( QByteArray data, const char * mime, int cf ) = 0
virtual QByteArray convertFromMime ( QByteArray data, const char * mime, int cf ) = 0

Static Public Members¶

void initialize ()
QPtrList<QWindowsMime> all ()
QWindowsMime * convertor ( const char * mime, int cf )
const char * cfToMime ( int cf )

DESCRIPTION¶

The QWindowsMime class maps open-standard MIME to Window Clipboard formats.

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

By instantiating subclasses of QWindowsMime that provide conversions between Windows Clipboard and MIME formats, you can convert proprietary clipboard formats to MIME formats.

Qt has predefined support for the following Windows Clipboard formats:

CF_UNICODETEXT - converted to "text/plain;charset=ISO-10646-UCS-2" and supported by QTextDrag.
CF_TEXT - converted to "text/plain;charset=system" or "text/plain" and supported by QTextDrag.
CF_DIB - converted to "image/*", where * is a Qt image format, and supported by QImageDrag.
CF_HDROP - converted to "text/uri-list", and supported by QUriDrag.

An example use of this class would be to map the Windows Metafile clipboard format (CF_METAFILEPICT) to and from the MIME type "image/x-wmf". This conversion might simply be adding or removing a header, or even just passing on the data. See the Drag-and-Drop documentation for more information on choosing and definition MIME types.

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¶

QWindowsMime::QWindowsMime ()¶

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

QWindowsMime::~QWindowsMime () [virtual]¶

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

QPtrList<QWindowsMime> QWindowsMime::all () [static]¶

Returns a list of all currently defined QWindowsMime objects.

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

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