Changeset 337

Timestamp:

Nov 22, 2009, 9:48:35 PM (16 years ago)

Author:

Dmitry A. Kuminov

Message:

gui/kernel: mime: Implemented the fallback mime <-> clipboard converter for mime types not explicitly supported by specialized QPMMime implementations (see #28).

Location:

trunk/src/gui/kernel

Files:

• qmime.h (modified) (1 diff)
• qmime_pm.cpp (modified) (15 diffs)

trunk/src/gui/kernel/qmime.h

@@ -135 +135 @@
                                        QVariant::Type preferredType) const = 0;
 
+
+
     static ULONG registerMimeType(const QString &mime);
 
     static ULONG allocateMemory(size_t size);
     static void freeMemory(ULONG addr);
+
+
 
 private:

trunk/src/gui/kernel/qmime_pm.cpp

@@ -100 +100 @@
     to MIME formats.
 
-    Qt has predefined support for the following PM Clipboard formats:
+    Qt has predefined support for the following PM Clipboard formats (custom
+    formats registered in the system atom table by name are given in double
+    quotes):
 
     \table
     \header \o PM Format \o Equivalent MIME type
-    \row \o \c CF_TEXT        \o \c text/plain
-    \row \o \c CF_BITMAP      \o \c{image/xyz}, where \c xyz is
-                                 a \l{QImageWriter::supportedImageFormats()}{Qt image format}
+    \row \o \c CF_TEXT          \o \c text/plain (system codepage,
+                                   zero-terminated string)
+    \row \o \c "text/unicode"   \o \c text/plain (16-bit Unicode, Mozilla-compatible,
+                                   zero-terminated string)
+    \row \o \c CF_BITMAP        \o \c{image/xyz}, where \c xyz is
+                                    a \l{QImageWriter::supportedImageFormats()}{Qt image format}
+    \row \o \c "x-mime:<mime>"  \o data in the format corresponding to the given
+                                   MIME type \c <mime>
     \endtable
 
-    An example use of this class would be to map the PM Metafile
-    clipboard format (\c CF_METAFILE) to and from the MIME type
+    Note that all "x-mime:<mime>" formats use the CFI_POINTER storage type. That
+    is, the clipboard contains a pointer to the memory block containing the MIME
+    data in the corresponding format. The first 4 bytes of this memory block
+    always contain the length of the subsequent MIME data array, in bytes.
+
+    An example use of this class by the user application would be to map the
+    PM Metafile clipboard format (\c CF_METAFILE) to and from the MIME type
     \c{image/x-metafile}. This conversion might simply be adding or removing a
     header, or even just passing on the data. See \l{Drag and Drop} for more
@@ -167 +179 @@
     ULONG data = 0;
 
-    // allocate giveable memory for the array + dword for its size
-    APIRET arc = DosAllocSharedMem((PVOID *)&data, NULL, size + 4,
+    // allocate giveable memory for the array
+    APIRET arc = DosAllocSharedMem((PVOID *)&data, NULL, size,
                                    PAG_WRITE  | PAG_COMMIT | OBJ_GIVEABLE);
     if (arc != NO_ERROR) {
@@ -177 +189 @@
     }
 
-    /// @todo I think we don't need it any more
-#if 0
-    // get the size rounded to the page boundary (4K)
-    ULONG sz = ~0, flags = 0;
-    arc = DosQueryMem((PVOID)(data + size - 1), &sz, &flags);
-    if (arc != NO_ERROR) {
-#ifndef QT_NO_DEBUG
-        qWarning("QPMMime::allocateMemory: DosQueryMem failed with %lu", arc);
-#endif
-        DosFreeMem((PVOID)data);
-        return 0;
-    }
-    sz += (size - 1);
-    // store the exact size to the last dword of the last page
-    *(((ULONG *)(data + sz)) - 1) = size;
-#endif
-
     return data;
 }
@@ -226 +221 @@
     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
+    If \a data is not NULL, a handle to the converted data should  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:
+    The following flags describing the data type are recognized:
 
     \table
@@ -280 +275 @@
 
     QList<QPMMime*> mimes = theMimeList()->mimes();
-    for (int i = mimes.size()-1; i >= 0; --i) {
-        QList<MimeCFPair> fmts = mimes[i]->mimesForFormats(formats);
+    for) {
+        QList<MimeCFPair> fmts = mime->mimesForFormats(formats);
         int priority = 0;
         foreach (MimeCFPair fmt, fmts) {
@@ -291 +286 @@
                     // replace if priority is higher, ignore otherwise
                     if (priority < match.priority) {
-                        match.converter = mimes[i];
+                        match.converter = mime;
                         match.format = fmt.second;
                         match.priority = priority;
@@ -299 +294 @@
             }
             if (it == matches.end()) {
-                matches += Match(mimes[i], fmt.first, fmt.second, priority);
+                matches += Match(mime, fmt.first, fmt.second, priority);
             }
         }
@@ -313 +308 @@
 
     QList<QPMMime*> mimes = theMimeList()->mimes();
-    for (int i = mimes.size()-1; i >= 0; --i) {
-        QList<ULONG> cfs = mimes[i]->formatsForMimeData(mimeData);
+    for) {
+        QList<ULONG> cfs = mime->formatsForMimeData(mimeData);
         int priority = 0;
         foreach (ULONG cf, cfs) {
@@ -324 +319 @@
                     // replace if priority is higher, ignore otherwise
                     if (priority < match.priority) {
-                        match.converter = mimes[i];
+                        match.converter = mime;
                         match.priority = priority;
                     }
@@ -331 +326 @@
             }
             if (it == matches.end()) {
-                matches += Match(mimes[i], cf, priority);
+                matches += Match(mime, cf, priority);
             }
         }
@@ -337 +332 @@
 
     return matches;
+
+
+
+
+
+
+
+
+
+
+
+
+
 }
 
@@ -346 +354 @@
     QPMMimeText();
 
+
     QList<ULONG> formatsForMimeData(const QMimeData *mimeData) const;
     bool convertFromMimeData(const QMimeData *mimeData, ULONG format,
                              ULONG &flags, ULONG *data) const;
 
+
     QList<MimeCFPair> mimesForFormats(const QList<ULONG> &formats) const;
     QVariant convertFromFormat(ULONG format, ULONG flags, ULONG data,
@@ -519 +529 @@
 ////////////////////////////////////////////////////////////////////////////////
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 QPMMimeList::QPMMimeList()
     : initialized(false)
@@ -535 +735 @@
     if (!initialized) {
         initialized = true;
+
         new QPMMimeText;
     }
@@ -542 +743 @@
 {
     init();
-    list.append(mime);
+    list.pend(mime);
 }