Spec-Zone.ru › Qt 5.14

Класс QWinMime

Класс QWinMime отображает MIME-форматы открытых стандартов в форматы буфера обмена Windows. Подробнее...

Заголовок: #include <QWinMime>
qmake: QT += winextras
С момента: Qt 5.4

Этот класс был представлен в Qt 5.4.

  • Список всех членов, включая унаследованные

Открытые функции

QWinMime()
virtual ~QWinMime()
virtual bool canConvertFromMime(const FORMATETC &formatetc, const QMimeData *mimeData) const = 0
virtual bool canConvertToMime(const QString &mimeType, IDataObject *pDataObj) const = 0
virtual bool convertFromMime(const FORMATETC &formatetc, const QMimeData *mimeData, STGMEDIUM *pmedium) const = 0
virtual QVariant convertToMime(const QString &mimeType, IDataObject *pDataObj, QVariant::Type preferredType) const = 0
virtual QVector<FORMATETC> formatsForMime(const QString &mimeType, const QMimeData *mimeData) const = 0
virtual QString mimeForFormat(const FORMATETC &formatetc) const = 0

Статические открытые члены

int registerMimeType(const QString &mime)

Подробное описание

Утилиты перетаскивания и буфера обмена Qt используют стандарт MIME. В X11 это просто отображается в протокол Xdnd, но в Windows, хотя некоторые приложения используют MIME-типы для описания форматов буфера обмена, другие используют произвольные нестандартизованные соглашения об именовании или встроенные неименованные форматы Windows.

Создавая подклассы QWinMime, обеспечивающие преобразования между буфером обмена Windows и форматами MIME, вы можете преобразовывать проприетарные форматы буфера обмена в MIME-форматы.

Qt имеет предопределённую поддержку следующих форматов буфера обмена Windows:

Формат Windows Эквивалентный MIME-тип
CF_UNICODETEXT text/plain
CF_TEXT text/plain
CF_DIB image/xyz, где xyz — формат изображения Qt
CF_HDROP text/uri-list
CF_INETURL text/uri-list
CF_HTML text/html

Пример использования этого класса — отображение формата метафайла Windows в буфере обмена (CF_METAFILEPICT) и обратно в MIME-тип image/x-wmf. Это преобразование может просто добавлять или удалять заголовок, или даже просто передавать данные. Дополнительную информацию о выборе и определении MIME-типов см. в разделе Перетаскивание.

Вы можете проверить, можно ли преобразовать MIME-тип, используя canConvertFromMime(), и выполнить преобразования с помощью convertToMime() и convertFromMime().

Документация по функциям-членам

QWinMime::QWinMime()

Создаёт новый объект преобразования, добавляя его в глобальный список доступных преобразователей.

[virtual] QWinMime::~QWinMime()

Удаляет объект преобразования, удаляя его из глобального списка доступных преобразователей.

[pure virtual] bool QWinMime::canConvertFromMime(const FORMATETC &formatetc, const QMimeData *mimeData) const

Возвращает true, если преобразователь может преобразовать данные из mimeData в формат, указанный в formatetc.

Все подклассы должны переопределить эту чистую виртуальную функцию.

[pure virtual] bool QWinMime::canConvertToMime(const QString &mimeType, IDataObject *pDataObj) const

Возвращает true, если преобразователь может преобразовать данные в mimeType из доступных форматов в pDataObj.

Все подклассы должны переопределить эту чистую виртуальную функцию.

[pure virtual] bool QWinMime::convertFromMime(const FORMATETC &formatetc, const QMimeData *mimeData, STGMEDIUM *pmedium) const

Преобразует данные mimeData в формат, указанный в formatetc. Преобразованные данные должны быть помещены в структуру pmedium.

Возвращает true, если преобразование успешно.

Все подклассы должны переопределить эту чистую виртуальную функцию.

[pure virtual] QVariant QWinMime::convertToMime(const QString &mimeType, IDataObject *pDataObj, QVariant::Type preferredType) const

Возвращает QVariant, содержащую преобразованные данные для mimeType из pDataObj. Если возможно, QVariant должна иметь тип preferredType, чтобы избежать ненужных преобразований.

Все подклассы должны переопределить эту чистую виртуальную функцию.

[pure virtual] QVector<FORMATETC> QWinMime::formatsForMime(const QString &mimeType, const QMimeData *mimeData) const

Возвращает QVector структур FORMATETC, представляющих различные форматы буфера обмена Windows, которые могут быть предоставлены для mimeType из mimeData.

Все подклассы должны переопределить эту чистую виртуальную функцию.

[pure virtual] QString QWinMime::mimeForFormat(const FORMATETC &formatetc) const

Возвращает MIME-тип, который будет создан из формата, указанного в formatetc, или пустую строку, если этот преобразователь не поддерживает formatetc.

Все подклассы должны переопределить эту чистую виртуальную функцию.

[static] int QWinMime::registerMimeType(const QString &mime)

Регистрирует MIME-тип mime и возвращает идентификатор, определяющий формат в Windows.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.14/qwinmime.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API