QMimeData的使用以及说明文档

目录

一、QMimeData的说明文档

二、MIME类型

三、QMimeData的描述

三、三种可将自定义数据存储在QMimeData对象中的方法

四、特定平台的MIME类型


一、QMimeData的说明文档

QMimeData()

构造一个新的MIME数据对象,其中没有数据。

void clear()

删除对象中的所有MIME类型和数据条目。

QVariant colorData()

如果存储在对象中的数据表示一种颜色(MIME类型:application / x-color),则返回一种颜色;否则返回空的QVariant。要将QVariant转换为QColor,只需使用qvariant_cast()。

例:

  if (event->mimeData()->hasColor()) {
      QColor color = qvariant_cast<QColor>(event->mimeData()->colorData());
      ...
  }
QByteArray data(const QString &mimeType)

以参数指定的MIME类型描述的格式返回存储在对象中的数据。

QStringList formats()

返回对象支持的格式列表。 这是对象可以为其返回合适数据的MIME类型的列表。 列表中的格式按优先级顺序排列。对于最常见的数据类型,可以使用hasText()、hasHtml()、hasUrls()、hasImage()、hasColor()。

bool hasColor() const

是否可以返回颜色(application / x-color)类型。

[virtual] bool hasFormat(const QString &mimeType)

可以返回参数指定的MIME类型的数据。

bool hasHtml()

是否可以返回HTML(text / html)类型。

bool hasText()

是否可以返回文本(text / plain)类型。

bool hasUrls()

是否可以返回网址列表(text / uri-list)。

是否可以返回网址列表(text / uri-list)。

如果存储在对象中的数据是HTML(text / html),则返回一个字符串。

QVariant imageData()

如果对象可以返回图像,则返回存储QImage的QVariant;否则,返回空的QVariant。要将QVariant转换为QImage,只需使用qvariant_cast()。

例如:

 if (event->mimeData()->hasImage()) {
     QImage image = qvariant_cast<QImage>(event->mimeData()->imageData());
     ...
 }
void removeFormat(const QString &mimeType)

删除对象中相应格式的数据条目。

QVariant retrieveData(const QString &mimeType, QVariant::Type type)

返回具有给定类型的QVariant,其中包含mimeType指定的MIME类型的数据。 如果对象不支持给定的MIME类型或变体类型,则返回空QVariant。通用data()获取器和便捷函数(text(),html(),urls(),imageData()和colorData())调用此函数。如果要使用自定义数据结构(而不是setData()提供的QByteArray)存储数据,则可以重新实现它。然后还需要重新实现hasFormat()和format()。

void setColorData(const QVariant &color)

将对象中的颜色数据设置为给定的颜色。颜色对应于MIME类型application / x-color。

void setData(const QString &mimeType, const QByteArray &data)

将与mimeType给出的MIME类型关联的数据设置为指定的数据。对于最常见的数据类型,可以调用更高级别的函数setText()、setHtml()、setUrls()、setImageData()、setColorData()。如果要在项目视图的拖放操作中使用自定义数据类型,则必须使用Q_DECLARE_METATYPE()宏将其注册为Qt元类型,并为其实现流运算符。然后必须使用qRegisterMetaTypeStreamOperators()函数注册流运算符。

例,设置自定义数据类型为MIME类型:

struct customData
{
    customData() {}
    int one;
    bool two;
    QString three;
    operator QVariant() const
    {
        return QVariant::fromValue(*this);
    }
    friend QDataStream& operator<<(QDataStream& out, const customData& player);
    friend QDataStream& operator>>(QDataStream& in, customData& player);
    friend QDebug operator<<(QDebug dbg, const customData&);
};
inline QDataStream& operator<<(QDataStream& out, const customData& player)
{
    out << player.one;
    out << player.two;
    out << player.three;
    return out;
}
inline QDataStream& operator>>(QDataStream& in, customData& player)
{
    in >> player.one;
    in >> player.two;
    in >> player.three;
    return in;
}
QDebug operator<<(QDebug dbg, const customData & c)
{
    dbg.nospace() << QStringLiteral("customData输出") << "{ one = " << c.one <<" two = "<< c.two << "three = " <<c.three <<"}";
    return dbg;
}
 
Q_DECLARE_METATYPE(customData);
 
int main(int argc, char *argv[])
{   
    //注册类型
    qRegisterMetaTypeStreamOperators<customData>("customData");
 
    //设置自定义类型
    customData custData;
    custData.one = 100;
    custData.two = true;
    custData.three = "xxxx";
    QMimeData mimeData;
 
    QByteArray outBa;
    outBa.resize(sizeof(customData));
 
    QBuffer buffer(&outBa);
    buffer.open(QIODevice::WriteOnly);
    QDataStream out(&buffer);
    out << custData;
    buffer.close();
 
    mimeData.setData("application/customDate",outBa);
 
    //输出数据
    QByteArray inBa = mimeData.data("application/customDate");
    QBuffer buf(&inBa);
    buf.open(QIODevice::ReadOnly);
    QDataStream in(&buf);
    customData custData2;
    in>>custData2;
    qDebug()<< custData2;
}
void setHtml(const QString &html)

将内容设置为用于表示数据的HTML(MIME类型text / html)。

void setImageData(const QVariant &image)

将对象中的数据设置为给定的图像。从QImage到QVariant的转换是隐式的。

例:

mimeData->setImageData(QImage("beautifulfjord.png"));
void setText(const QString &text)

将文本设置为用于表示数据的纯文本(MIME类型text/plain)。

void setUrls(const QList<QUrl> &urls)

将存储在MIME数据对象中的URL设置为参数指定的URL。(MIME类型的text / uri-list)。

QString text()

返回数据的纯文本(MIME类型text/plain)表示形式。

QList<QUrl> urls()

返回MIME数据对象中包含的URL列表。

二、MIME类型

MIME 消息能包含文本、图像、音频、视频以及其他应用程序专用的数据。具体类型见:MIME 参考手册 。

三、QMimeData的描述

1、QMimeData类是记录有关其MIME类型的信息的数据提供容器。

2、QMimeData用于描述可以存储在剪贴板中并通过拖放机制传输的信息。QMimeData对象将它们所持有的数据与相应的MIME类型相关联,以确保信息可以在应用程序之间安全地传输,并在同一应用程序中进行复制。

3、QMimeData对象通常使用new创建,并提供给QDrag或QClipboard对象。这是为了使Qt能够管理它们使用的内存。

4、一个QMimeData对象可以同时使用几种不同的格式存储相同的数据。 format()函数按首选项顺序返回可用格式的列表。 data()函数返回与MIME类型关联的原始数据,setData()为MIME类型设置数据。

例:一个接受URL拖动的小部件的代码:

  void MyWidget::dragEnterEvent(QDragEnterEvent *event)
  {
      if (event->mimeData()->hasUrls())
          event->acceptProposedAction();
  }
 
  void MyWidget::dropEvent(QDropEvent *event)
  {
      if (event->mimeData()->hasUrls()) {
          foreach (QUrl url, event->mimeData()->urls()) {
              ...
          }
      }
  }

三、三种可将自定义数据存储在QMimeData对象中的方法

1、可以使用setData()将自定义数据作为QByteArray直接存储在QMimeData对象中。

例如:

  QByteArray csvData = ...;
 
  QMimeData *mimeData = new QMimeData;
  mimeData->setData("text/csv", csvData);

2、将QMimeData子类化,然后重新实现hasFormat(),formats()和retrieveData()。

3、如果拖放操作发生在单个应用程序中,则我们可以将QMimeData子类化,并在其中添加额外的数据,并在接收者的drop事件处理程序中使用qobject_cast()。

例如:

  void MyWidget::dropEvent(QDropEvent *event)
  {
      const MyMimeData *myData =
              qobject_cast<const MyMimeData *>(event->mimeData());
      if (myData) {
          //直接访问myData的数据(不通过QMimeData的API)
      }
  }

四、特定平台的MIME类型

在Windows系统,formats()还将使用x-qt-windows-mime子类型返回MIME数据中可用的自定义格式,以指示它们表示非标准格式的数据。 格式将采用以下形式:

application/x-qt-windows-mime;value="<custom type>"

例如:

application/x-qt-windows-mime;value="FileGroupDescriptor"
application/x-qt-windows-mime;value="FileContents"
每种格式的值声明描述了数据编码的方式。可以使用多个数据值。 可以通过添加索引值来访问它们: 
application/x-qt-windows-mime;value="FileContents";index=0
application/x-qt-windows-mime;value="FileContents";index=1
在Windows系统,MIME格式并不总是直接映射到剪贴板格式。Qt提供QWinMime来将剪贴板格式映射为开放标准的MIME格式。 同样,QMacPasteboardMime将MIME映射到Mac系统。

相关推荐

  1. .gitignore 文件说明文档

    2024-07-10 16:18:03       28 阅读
  2. HTML文档说明

    2024-07-10 16:18:03       31 阅读
  3. Eureka使用说明

    2024-07-10 16:18:03       58 阅读
  4. QT 常用模块介绍以及使用说明

    2024-07-10 16:18:03       32 阅读
  5. 【React】useCallback 使用说明

    2024-07-10 16:18:03       59 阅读

最近更新

  1. docker php8.1+nginx base 镜像 dockerfile 配置

    2024-07-10 16:18:03       51 阅读
  2. Could not load dynamic library ‘cudart64_100.dll‘

    2024-07-10 16:18:03       54 阅读
  3. 在Django里面运行非项目文件

    2024-07-10 16:18:03       44 阅读
  4. Python语言-面向对象

    2024-07-10 16:18:03       55 阅读

热门阅读

  1. 【国产开源可视化引擎Meta2d.js】视频

    2024-07-10 16:18:03       22 阅读
  2. Apache Doris的分区与分桶原理解析

    2024-07-10 16:18:03       14 阅读
  3. Stream流的简单用法

    2024-07-10 16:18:03       26 阅读
  4. liunx上修改Firefox版本号

    2024-07-10 16:18:03       17 阅读
  5. PS设计新手如何学习?沈阳PS设计线下培训

    2024-07-10 16:18:03       19 阅读
  6. 深度学习进阶

    2024-07-10 16:18:03       16 阅读
  7. 提示学习的本质是KNN

    2024-07-10 16:18:03       19 阅读
  8. Tomcat

    Tomcat

    2024-07-10 16:18:03      17 阅读
  9. pytorch 源码阅读(1)——torch.complie

    2024-07-10 16:18:03       15 阅读
  10. weapp.socket.io.js

    2024-07-10 16:18:03       14 阅读
  11. 内网和外网的区别及应用

    2024-07-10 16:18:03       22 阅读
  12. Symfony Monorepo:一站式开发的艺术与实践

    2024-07-10 16:18:03       22 阅读
  13. Docker 深度分析与选型指南

    2024-07-10 16:18:03       23 阅读