QWindowsMimeImage Class Reference

Inheritance diagram for QWindowsMimeImage:

Public Functions
bool	canConvertFromMime (const FORMATETC &formatetc, const QMimeData *mimeData) const
	Returns true if the converter can convert from the mimeData to the format specified in formatetc. More...
bool	canConvertToMime (const QString &mimeType, IDataObject *pDataObj) const
	Returns true if the converter can convert to the mimeType from the available formats in pDataObj. More...
bool	convertFromMime (const FORMATETC &formatetc, const QMimeData *mimeData, STGMEDIUM *pmedium) const
	Convert the mimeData to the format specified in formatetc. More...
QVariant	convertToMime (const QString &mime, IDataObject *pDataObj, QVariant::Type preferredType) const
	Returns a QVariant containing the converted data for mimeType from pDataObj. More...
QVector< FORMATETC >	formatsForMime (const QString &mimeType, const QMimeData *mimeData) const
	Returns a QVector of FORMATETC structures representing the different windows clipboard formats that can be provided for the mimeType from the mimeData. More...
QString	mimeForFormat (const FORMATETC &formatetc) const
	Returns the mime type that will be created form the format specified in formatetc, or an empty string if this converter does not support formatetc. More...
	QWindowsMimeImage ()
Public Functions inherited from QWindowsMime
	QWindowsMime ()
	Constructs a new conversion object, adding it to the globally accessed list of available converters. More...
virtual	~QWindowsMime ()
	Destroys a conversion object, removing it from the global list of available converters. More...

Private Functions
bool	hasOriginalDIBV5 (IDataObject *pDataObj) const

Properties
UINT	CF_PNG

Additional Inherited Members
Static Public Functions inherited from QWindowsMime
static int	registerMimeType (const QString &mime)
	Registers the MIME type mime, and returns an ID number identifying the format on Windows. More...

Detailed Description

Definition at line 882 of file qmime_win.cpp.

Constructors and Destructors

QWindowsMimeImage()

QWindowsMimeImage::QWindowsMimeImage

(

)

Definition at line 900 of file qmime_win.cpp.

{
    CF_PNG = RegisterClipboardFormat(L"PNG");
}

Functions

canConvertFromMime()

bool QWindowsMimeImage::canConvertFromMime ( const FORMATETC &  formatetc, const QMimeData *  mimeData  ) const

virtual

Returns true if the converter can convert from the mimeData to the format specified in formatetc.

All subclasses must reimplement this pure virtual function.

Implements QWindowsMime.

Definition at line 934 of file qmime_win.cpp.

{
    int cf = getCf(formatetc);
    if (mimeData->hasImage()) {
        if (cf == CF_DIB)
            return true;
        else if (cf == CF_DIBV5) {
            //support DIBV5 conversion only if the image has alpha channel
            QImage image = qvariant_cast<QImage>(mimeData->imageData());
            if (!image.isNull() && image.hasAlphaChannel())
                return true;
        }
    }
    return false;
}

canConvertToMime()

bool QWindowsMimeImage::canConvertToMime ( const QString &  mimeType, IDataObject *  pDataObj  ) const

virtual

Returns true if the converter can convert to the mimeType from the available formats in pDataObj.

All subclasses must reimplement this pure virtual function.

Implements QWindowsMime.

Definition at line 926 of file qmime_win.cpp.

{
    if ((mimeType == QLatin1String("application/x-qt-image")) &&
        (canGetData(CF_DIB, pDataObj) || canGetData(CF_PNG, pDataObj)))
        return true;
    return false;
}

convertFromMime()

bool QWindowsMimeImage::convertFromMime ( const FORMATETC &  formatetc, const QMimeData *  mimeData, STGMEDIUM *  pmedium  ) const

virtual

Convert the mimeData to the format specified in formatetc.

The converted data should then be placed in pmedium structure.

Return true if the conversion was successful.

All subclasses must reimplement this pure virtual function.

Implements QWindowsMime.

Definition at line 950 of file qmime_win.cpp.

{
    int cf = getCf(formatetc);
    if ((cf == CF_DIB || cf == CF_DIBV5) && mimeData->hasImage()) {
        QImage img = qvariant_cast<QImage>(mimeData->imageData());
        if (img.isNull())
            return false;
        QByteArray ba;
        QDataStream s(&ba, QIODevice::WriteOnly);
        s.setByteOrder(QDataStream::LittleEndian);// Intel byte order ####
        if (cf == CF_DIB) {
            if (img.format() > QImage::Format_ARGB32)
                img = img.convertToFormat(QImage::Format_RGB32);
            if (qt_write_dib(s, img))
                return setData(ba, pmedium);
        } else {
            if (qt_write_dibv5(s, img))
                return setData(ba, pmedium);
        }
    }
    return false;
}

convertToMime()

QVariant QWindowsMimeImage::convertToMime ( const QString &  mimeType, IDataObject *  pDataObj, QVariant::Type  preferredType  ) const

virtual

Returns a QVariant containing the converted data for mimeType from pDataObj.

If possible the QVariant should be of the preferredType to avoid needless conversions.

All subclasses must reimplement this pure virtual function.

Implements QWindowsMime.

Definition at line 995 of file qmime_win.cpp.

{
    Q_UNUSED(preferredType);
    QVariant result;
    if (mimeType != QLatin1String("application/x-qt-image"))
        return result;
    //Try to convert from a format which has more data
    //DIBV5, use only if its is not synthesized
    if (canGetData(CF_DIBV5, pDataObj) && hasOriginalDIBV5(pDataObj)) {
        QImage img;
        QByteArray data = getData(CF_DIBV5, pDataObj);
        QDataStream s(&data, QIODevice::ReadOnly);
        s.setByteOrder(QDataStream::LittleEndian);
        if (qt_read_dibv5(s, img)) { // #### supports only 32bit DIBV5
            return img;
        }
    }
    //PNG, MS Office place this (undocumented)
    if (canGetData(CF_PNG, pDataObj)) {
        QImage img;
        QByteArray data = getData(CF_PNG, pDataObj);
        if (img.loadFromData(data, "PNG")) {
            return img;
        }
    }
    //Fallback to DIB
    if (canGetData(CF_DIB, pDataObj)) {
        QImage img;
        QByteArray data = getData(CF_DIB, pDataObj);
        QDataStream s(&data, QIODevice::ReadOnly);
        s.setByteOrder(QDataStream::LittleEndian);// Intel byte order ####
        if (qt_read_dib(s, img)) { // ##### encaps "-14"
            return img;
        }
    }
    // Failed
    return result;
}

formatsForMime()

QVector< FORMATETC > QWindowsMimeImage::formatsForMime ( const QString &  mimeType, const QMimeData *  mimeData  ) const

virtual

Returns a QVector of FORMATETC structures representing the different windows clipboard formats that can be provided for the mimeType from the mimeData.

All subclasses must reimplement this pure virtual function.

Implements QWindowsMime.

Definition at line 905 of file qmime_win.cpp.

{
    QVector<FORMATETC> formatetcs;
    if (mimeData->hasImage() && mimeType == QLatin1String("application/x-qt-image")) {
        //add DIBV5 if image has alpha channel
        QImage image = qvariant_cast<QImage>(mimeData->imageData());
        if (!image.isNull() && image.hasAlphaChannel())
            formatetcs += setCf(CF_DIBV5);
        formatetcs += setCf(CF_DIB);
    }
    return formatetcs;
}

hasOriginalDIBV5()

bool QWindowsMimeImage::hasOriginalDIBV5 ( IDataObject *  pDataObj ) const

private

Definition at line 973 of file qmime_win.cpp.

{
    bool isSynthesized = true;
    IEnumFORMATETC *pEnum =NULL;
    HRESULT res = pDataObj->EnumFormatEtc(1, &pEnum);
    if (res == S_OK && pEnum) {
        FORMATETC fc;
        while ((res = pEnum->Next(1, &fc, 0)) == S_OK) {
            if (fc.ptd)
                CoTaskMemFree(fc.ptd);
            if (fc.cfFormat == CF_DIB)
                break;
            else if (fc.cfFormat == CF_DIBV5) {
                isSynthesized  = false;
                break;
            }
        }
        pEnum->Release();
    }
    return !isSynthesized;
}

mimeForFormat()

QString QWindowsMimeImage::mimeForFormat ( const FORMATETC &  formatetc ) const

virtual

Returns the mime type that will be created form the format specified in formatetc, or an empty string if this converter does not support formatetc.

All subclasses must reimplement this pure virtual function.

Implements QWindowsMime.

Definition at line 918 of file qmime_win.cpp.

{
    int cf = getCf(formatetc);
    if (cf == CF_DIB || cf == CF_DIBV5 || cf == int(CF_PNG))
       return QLatin1String("application/x-qt-image");
    return QString();
}

Properties

CF_PNG

UINT QWindowsMimeImage::CF_PNG

private

Definition at line 897 of file qmime_win.cpp.

---

The documentation for this class was generated from the following file:

• /src/gui/kernel/qmime_win.cpp