~oif-team/ubuntu/natty/qt4-x11/xi2.1

<td width="1">  </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a> · <a href="classes.html"><font color="#004faf">All Classes</font></a> · <a href="functions.html"><font color="#004faf">All Functions</font></a> · <a href="overviews.html"><font color="#004faf">Overviews</font></a></td><td class="searchBar" align="right" valign="center"><form action="http://www.google.com/cse" id="cse-search-box"><div><input type="hidden" name="cx" value="000136343326384750312:dhbxnqlakyu" /><input type="hidden" name="ie" value="UTF-8" /><input type="text" name="q" size="31" /><input type="submit" name="sa" value="Search" /></div></form></td>

</tr></table><h1 class="title">QMacPasteboardMime Class Reference<br /><span class="small-subtitle">[<a href="qtgui.html">QtGui</a> module]</span>

</h1>

<p>The QMacPasteboardMime class converts between a MIME type and a <a href="http://developer.apple.com/macosx/uniformtypeidentifiers.html">Uniform Type Identifier (UTI)</a> format. <a href="#details">More...</a></p>

<pre> #include <QMacPasteboardMime></pre><p>This class was introduced in Qt 4.2.</p>

<ul>

<li><a href="qmacpasteboardmime-members.html">List of all members, including inherited members</a></li>

</ul>

<hr />

<h2>Public Functions</h2>

<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qmacpasteboardmime.html#QMacPasteboardMime">QMacPasteboardMime</a></b> ( char <i>t</i> )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><b><a href="qmacpasteboardmime.html#dtor.QMacPasteboardMime">~QMacPasteboardMime</a></b> ()</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qmacpasteboardmime.html#canConvert">canConvert</a></b> ( const QString & <i>mime</i>, QString <i>flav</i> ) = 0</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">virtual QList<QByteArray> </td><td class="memItemRight" valign="bottom"><b><a href="qmacpasteboardmime.html#convertFromMime">convertFromMime</a></b> ( const QString & <i>mime</i>, QVariant <i>data</i>, QString <i>flav</i> ) = 0</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">virtual QVariant </td><td class="memItemRight" valign="bottom"><b><a href="qmacpasteboardmime.html#convertToMime">convertToMime</a></b> ( const QString & <i>mime</i>, QList<QByteArray> <i>data</i>, QString <i>flav</i> ) = 0</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">virtual QString </td><td class="memItemRight" valign="bottom"><b><a href="qmacpasteboardmime.html#convertorName">convertorName</a></b> () = 0</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">virtual QString </td><td class="memItemRight" valign="bottom"><b><a href="qmacpasteboardmime.html#flavorFor">flavorFor</a></b> ( const QString & <i>mime</i> ) = 0</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">virtual QString </td><td class="memItemRight" valign="bottom"><b><a href="qmacpasteboardmime.html#mimeFor">mimeFor</a></b> ( QString <i>flav</i> ) = 0</td></tr>

</table>

<hr />

<h2>Static Public Members</h2>

<tr><td class="memItemLeft" align="right" valign="top">QList<QMacPasteboardMime *> </td><td class="memItemRight" valign="bottom"><b><a href="qmacpasteboardmime.html#all">all</a></b> ( uchar <i>t</i> )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QMacPasteboardMime * </td><td class="memItemRight" valign="bottom"><b><a href="qmacpasteboardmime.html#convertor">convertor</a></b> ( uchar <i>t</i>, const QString & <i>mime</i>, QString <i>flav</i> )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qmacpasteboardmime.html#flavorToMime">flavorToMime</a></b> ( uchar <i>t</i>, QString <i>flav</i> )</td></tr>

</table>

<hr />

<h2>Related Non-Members</h2>

<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qmacpasteboardmime.html#qRegisterDraggedTypes">qRegisterDraggedTypes</a></b> ( const QStringList & <i>types</i> )</td></tr>

</table>

<hr />

<h2>Detailed Description</h2>

<p>The QMacPasteboardMime class converts between a MIME type and a <a href="http://developer.apple.com/macosx/uniformtypeidentifiers.html">Uniform Type Identifier (UTI)</a> format.</p>

<p>Qt's drag and drop and clipboard facilities use the MIME standard. On X11, this maps trivially to the Xdnd protocol. On Mac, although some applications use MIME to describe clipboard contents, it is more common to use Apple's UTI format.</p>

<p>QMacPasteboardMime's role is to bridge the gap between MIME and UTI; By subclasses this class, one can extend Qt's drag and drop and clipboard handling to convert to and from unsupported, or proprietary, UTI formats.</p>

<p>A subclass of QMacPasteboardMime will automatically be registered, and active, upon instantiation.</p>

<p>Qt has predefined support for the following UTIs:</p>

<ul>

<li>public.utf8-plain-text - converts to "text/plain"</li>

<li>public.utf16-plain-text - converts to "text/plain"</li>

<li>public.html - converts to "text/html"</li>

<li>public.url - converts to "text/uri-list"</li>

<li>public.file-url - converts to "text/uri-list"</li>

<li>public.tiff - converts to "application/x-qt-image"</li>

<li>com.apple.traditional-mac-plain-text - converts to "text/plain"</li>

<li>com.apple.pict - converts to "application/x-qt-image"</li>

</ul>

<p>When working with MIME data, Qt will interate through all instances of QMacPasteboardMime to find an instance that can convert to, or from, a specific MIME type. It will do this by calling <a href="qmacpasteboardmime.html#canConvert">canConvert</a>() on each instance, starting with (and choosing) the last created instance first. The actual conversions will be done by using <a href="qmacpasteboardmime.html#convertToMime">convertToMime</a>() and <a href="qmacpasteboardmime.html#convertFromMime">convertFromMime</a>().</p>

<p><b>Note:</b> The API uses the term "flavor" in some cases. This is for backwards compatibility reasons, and should now be understood as UTIs.</p>

<hr />

<h2>Member Function Documentation</h2>

<h3 class="fn"><a name="QMacPasteboardMime"></a>QMacPasteboardMime::QMacPasteboardMime ( char <i>t</i> )</h3>

<p>Constructs a new conversion object of type <i>t</i>, adding it to the globally accessed list of available convertors.</p>

<h3 class="fn"><a name="dtor.QMacPasteboardMime"></a>QMacPasteboardMime::~QMacPasteboardMime ()  <tt> [virtual]</tt></h3>

<p>Destroys a conversion object, removing it from the global list of available convertors.</p>

<h3 class="fn"><a name="all"></a><a href="qlist.html">QList</a><QMacPasteboardMime *> QMacPasteboardMime::all ( <a href="qtglobal.html#uchar-typedef">uchar</a> <i>t</i> )  <tt> [static]</tt></h3>

<p>Returns a list of all currently defined <a href="qmacpasteboardmime.html">QMacPasteboardMime</a> objects of type <i>t</i>.</p>

<h3 class="fn"><a name="canConvert"></a>bool QMacPasteboardMime::canConvert ( const <a href="qstring.html">QString</a> & <i>mime</i>, <a href="qstring.html">QString</a> <i>flav</i> )  <tt> [pure virtual]</tt></h3>

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

<p>All subclasses must reimplement this pure virtual function.</p>

<h3 class="fn"><a name="convertFromMime"></a><a href="qlist.html">QList</a><<a href="qbytearray.html">QByteArray</a>> QMacPasteboardMime::convertFromMime ( const <a href="qstring.html">QString</a> & <i>mime</i>, <a href="qvariant.html">QVariant</a> <i>data</i>, <a href="qstring.html">QString</a> <i>flav</i> )  <tt> [pure virtual]</tt></h3>

<p>Returns <i>data</i> converted from MIME type <i>mime</i> to Mac UTI <i>flav</i>.</p>

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

<p>All subclasses must reimplement this pure virtual function.</p>

<h3 class="fn"><a name="convertToMime"></a><a href="qvariant.html">QVariant</a> QMacPasteboardMime::convertToMime ( const <a href="qstring.html">QString</a> & <i>mime</i>, <a href="qlist.html">QList</a><<a href="qbytearray.html">QByteArray</a>> <i>data</i>, <a href="qstring.html">QString</a> <i>flav</i> )  <tt> [pure virtual]</tt></h3>

<p>Returns <i>data</i> converted from Mac UTI <i>flav</i> to MIME type <i>mime</i>.</p>

<p>Note that Mac flavors must all be self-terminating. The input <i>data</i> may contain trailing data.</p>

<p>All subclasses must reimplement this pure virtual function.</p>

<h3 class="fn"><a name="convertor"></a>QMacPasteboardMime * QMacPasteboardMime::convertor ( <a href="qtglobal.html#uchar-typedef">uchar</a> <i>t</i>, const <a href="qstring.html">QString</a> & <i>mime</i>, <a href="qstring.html">QString</a> <i>flav</i> )  <tt> [static]</tt></h3>

<p>Returns the most-recently created <a href="qmacpasteboardmime.html">QMacPasteboardMime</a> of type <i>t</i> that can convert between the <i>mime</i> and <i>flav</i> formats. Returns 0 if no such convertor exists.</p>

<h3 class="fn"><a name="convertorName"></a><a href="qstring.html">QString</a> QMacPasteboardMime::convertorName ()  <tt> [pure virtual]</tt></h3>

100

<p>Returns a name for the convertor.</p>

101

<p>All subclasses must reimplement this pure virtual function.</p>

102

103

<h3 class="fn"><a name="flavorFor"></a><a href="qstring.html">QString</a> QMacPasteboardMime::flavorFor ( const <a href="qstring.html">QString</a> & <i>mime</i> )  <tt> [pure virtual]</tt></h3>

104

<p>Returns the Mac UTI used for MIME type <i>mime</i>, or 0 if this convertor does not support <i>mime</i>.</p>

105

<p>All subclasses must reimplement this pure virtual function.</p>

106

107

<h3 class="fn"><a name="flavorToMime"></a><a href="qstring.html">QString</a> QMacPasteboardMime::flavorToMime ( <a href="qtglobal.html#uchar-typedef">uchar</a> <i>t</i>, <a href="qstring.html">QString</a> <i>flav</i> )  <tt> [static]</tt></h3>

108

<p>Returns a MIME type of type <i>t</i> for <i>flav</i>, or 0 if none exists.</p>

109

110

<h3 class="fn"><a name="mimeFor"></a><a href="qstring.html">QString</a> QMacPasteboardMime::mimeFor ( <a href="qstring.html">QString</a> <i>flav</i> )  <tt> [pure virtual]</tt></h3>

111

<p>Returns the MIME UTI used for Mac flavor <i>flav</i>, or 0 if this convertor does not support <i>flav</i>.</p>

112

<p>All subclasses must reimplement this pure virtual function.</p>

113

<hr />

114

<h2>Related Non-Members</h2>

115

116

<h3 class="fn"><a name="qRegisterDraggedTypes"></a>void qRegisterDraggedTypes ( const <a href="qstringlist.html">QStringList</a> & <i>types</i> )</h3>

117

<p>Registers the given <i>types</i> as custom pasteboard types.</p>

118

<p>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 <a href="qmacpasteboardmime.html">QMacPasteboardMime</a> subclass implementation. By default drag and drop is enabled for all standard pasteboard types.</p>

119

<p>See also <a href="qmacpasteboardmime.html">QMacPasteboardMime</a>.</p>

120

121

122

123

<td width="20%" align="center"><a href="trademarks.html">Trademarks</a></td>

124

125

126

</html>

Older »