Changeset 324 for trunk/src/gui/kernel/qmime_pm.cpp

Timestamp:

Nov 18, 2009, 1:49:31 AM (16 years ago)

Author:

Dmitry A. Kuminov

Message:

gui/kernel: Improved mime <-> PM clipboard format conversion interfaces.

File:

• trunk/src/gui/kernel/qmime_pm.cpp (modified) (5 diffs)

trunk/src/gui/kernel/qmime_pm.cpp

@@ -114 +114 @@
     header, or even just passing on the data. See \l{Drag and Drop} for more
     information on choosing and definition MIME types.
-
-    You can check if a MIME type is convertible using canConvertFromMime() and
-    can perform conversions with convertToMime() and convertFromMime().
 */
 
@@ -158 +155 @@
 
 /*!
-    \fn bool QPMMime::canConvertFromMime(ULONG format, const QMimeData *mimeData) const
-
-    Returns true if the converter can convert from the \a mimeData to
-    the specified \a format.
+    \fn QList<ULONG> QPMMime::formatsForMimeData(const QMimeData *mimeData) const
+
+    Returns a list of ULONG values representing the different OS/2 PM
+    clipboard formats that can be provided for the \a mimeData, in order of
+    precedence (the most suitable format goes first), or an empty list if
+    neither of the mime types provided by \a mimeData is supported by this
+    converter.
 
     All subclasses must reimplement this pure virtual function.
@@ -167 +167 @@
 
 /*!
-    \fn bool QPMMime::convertFromMime(ULONG format, const QMimeData *mimeData,
-                                      ULONG &flags, ULONG &data) const
-
-    Convert the \a mimeData to the specified \a format.
-    The converted data should then be placed in the \a data variable with the
-    necessary flags returned in the \a flags variable.
+    \fn bool QPMMime::convertFromMimeData(const QMimeData *mimeData, ULONG format,
+                                          ULONG &flags, ULONG *data) const
+
+    Converts the \a mimeData to the specified \a format.
+
+    If \a data is not NULL, a handle to the converted data should then be placed
+    in a variable pointed to by \a data and with the necessary flags describing
+    the handle returned in the \a flags variable.
+
+    The following flags describing the data type are recognized:
+
+    \table
+    \row \o \c CFI_POINTER        \o \a data is a pointer to a block of memory
+                                      allocated with QPMMime::allocMem()
+    \row \o \c CFI_HANDLE         \o \a data is a handle to the appropriate
+                                      PM resource
+    \endtable
+
+    If \a data is NULL then a delayed conversion is requested by the caller.
+    The implementation should return the appropriate flags in the \a flags
+    variable and may perform the real data conversion later when this method is
+    called again with \a data being non-NULL.
 
     Return true if the conversion was successful.
@@ -180 +196 @@
 
 /*!
-    \fn QVector<ULONG> QPMMime::formatsForMime(const QString &mimeType, const QMimeData *mimeData) const
-
-    Returns a QVector of ULONG values representing the different OS/2 PM clipboard
-    formats that can be provided for the \a mimeType from the \a mimeData.
+    \fn QStringList QPMMime::mimesForFormats(const QList<ULONG> &formats) const
+
+    Returns a list of mime types that will be created form the specified \a list
+    of \a formats, in order of precedence (the most suitable mime type comes
+    first), or an empty list if neither of the \a formats is supported by this
+    converter.
 
     All subclasses must reimplement this pure virtual function.
@@ -189 +207 @@
 
 /*!
-    \fn bool QPMMime::canConvertToMime(const QString &mimeType, ULONG format) const
-
-    Returns true if the converter can convert to the \a mimeType from
-    the specified \a format.
+    \fn QVariant QPMMime::convertFromFormat(ULONG format, ULONG flags, ULONG data,
+                                            const QString &mimeType,
+                                            QVariant::Type preferredType) const
+
+    Returns a QVariant containing the converted from the \a data in the
+    specified \a format with the given \a flags to the requested \a mimeType. If
+    possible the QVariant should be of the \a preferredType to avoid needless
+    conversions.
 
     All subclasses must reimplement this pure virtual function.
 */
 
-/*!
-    \fn QVariant QPMMime::convertToMime(const QString &mimeType, QVariant::Type preferredType,
-                                        ULONG format, ULONG flags, ULONG data) const
-
-    Returns a QVariant containing the converted data for \a mimeType from the
-    \a data in the specified \a format and \a flags. If possible the QVariant
-    should be of the \a preferredType to avoid needless conversions.
-
-    All subclasses must reimplement this pure virtual function.
-*/
-
-/*!
-    \fn QString QPMMime::mimeForFormat(ULONG format) const
-
-    Returns the mime type that will be created form the specified \a format, or an
-    empty string if this converter does not support \a format.
-
-    All subclasses must reimplement this pure virtual function.
-*/
-
 // static
-QPMMime *QPMMime::converterToMime(const QString &mimeType, ULONG format)
-{
+QList<QPMMime::Match> QPMMime::allConvertersFromFormats(const QList<ULONG> &formats)
+{
+    QList<Match> matches;
+
     QList<QPMMime*> mimes = theMimeList()->mimes();
     for (int i = mimes.size()-1; i >= 0; --i) {
-        if (mimes.at(i)->canConvertToMime(mimeType, format))
-            return mimes.at(i);
-    }
-    return 0;
-}
-
-// static
-QStringList QPMMime::allMimesForFormats(const QVector<ULONG> &formats)
-{
-    QList<QPMMime*> mimes = theMimeList()->mimes();
-    QStringList fmts;
-
-    foreach(ULONG cf, formats) {
-#ifdef QMIME_DEBUG
-        HATOMTBL tbl = WinQuerySystemAtomTable();
-        ULONG len = WinQueryAtomLength(tbl, cf);
-        QByteArray atom(len, 0);
-        WinQueryAtomName(tbl, cf, atom.data(), atom.size() + 1 /* '\0' */);
-        qDebug("QPMMime::allMimesForFormats() CF %lu (%s)", cf, atom.constData());
-#endif
-        for (int i = mimes.size()-1; i >= 0; --i) {
-            QString format = mimes.at(i)->mimeForFormat(cf);
-            if (!format.isEmpty() && !fmts.contains(format)) {
-                fmts += format;
+        QStringList fmts = mimes[i]->mimesForFormats(formats);
+        int priority = 0;
+        foreach (QString fmt, fmts) {
+            ++priority;
+            QList<Match>::iterator it = matches.begin();
+            for (; it != matches.end(); ++it) {
+                Match &match = *it;
+                if (match.mime == fmt) {
+                    // replace if priority is higher, ignore otherwise
+                    if (priority < match.priority) {
+                        match.converter = mimes[i];
+                        match.priority = priority;
+                    }
+                    break;
+                }
+            }
+            if (it == matches.end()) {
+                matches += Match(mimes[i], fmt, priority);
             }
         }
     }
 
-    return fmts;
+    return matches;
 }
 
 // static
-QPMMime *QPMMime::converterFromMime(ULONG format, const QMimeData *mimeData)
-{
+QList<QPMMime::Match> QPMMime::allConvertersFromMimeData(const QMimeData *mimeData)
+{
+    QList<Match> matches;
+
     QList<QPMMime*> mimes = theMimeList()->mimes();
     for (int i = mimes.size()-1; i >= 0; --i) {
-        if (mimes.at(i)->canConvertFromMime(format, mimeData))
-            return mimes.at(i);
+        QList<ULONG> cfs = mimes[i]->formatsForMimeData(mimeData);
+        int priority = 0;
+        foreach (ULONG cf, cfs) {
+            ++priority;
+            QList<Match>::iterator it = matches.begin();
+            for (; it != matches.end(); ++it) {
+                Match &match = *it;
+                if (match.format == cf) {
+                    // replace if priority is higher, ignore otherwise
+                    if (priority < match.priority) {
+                        match.converter = mimes[i];
+                        match.priority = priority;
+                    }
+                    break;
+                }
+            }
+            if (it == matches.end()) {
+                matches += Match(mimes[i], cf, priority);
+            }
+        }
     }
-    return 0;
-}
-
-// static
-QVector<ULONG> QPMMime::allFormatsForMime(const QMimeData *mimeData)
-{
-    QList<QPMMime*> mimes = theMimeList()->mimes();
-    QVector<ULONG> cfs(4);
-    QStringList formats = QInternalMimeData::formatsHelper(mimeData);
-    for (int f = 0; f < formats.size(); ++f) {
-        for (int i = mimes.size()-1; i >= 0; --i)
-            cfs += mimes.at(i)->formatsForMime(formats.at(f), mimeData);
-    }
-    return cfs;
+
+    return matches;
 }