Класс QMimeType
Класс QMimeType описывает типы файлов или данных, представленные строкой MIME-типа. Подробнее...
| Заголовок: | #include <QMimeType> |
| qmake: | QT += core |
| С момента: | Qt 5.0 |
Этот класс был представлен в Qt 5.0.
Свойства
|
|
Открытые функции
| QMimeType(const QMimeType &other) | |
| QMimeType() | |
| QMimeType & | operator=(QMimeType &&other) |
| QMimeType & | operator=(const QMimeType &other) |
| ~QMimeType() | |
| QStringList | aliases() const |
| QStringList | allAncestors() const |
| QString | comment() const |
| QString | filterString() const |
| QString | genericIconName() const |
| QStringList | globPatterns() const |
| QString | iconName() const |
| bool | inherits(const QString &mimeTypeName) const |
| bool | isDefault() const |
| bool | isValid() const |
| QString | name() const |
| QStringList | parentMimeTypes() const |
| QString | preferredSuffix() const |
| QStringList | suffixes() const |
| void | swap(QMimeType &other) |
| bool | operator!=(const QMimeType &other) const |
| bool | operator==(const QMimeType &other) const |
Связанные нечлены
| uint | qHash(const QMimeType &key, uint seed = 0) |
Подробное описание
Например, файл с именем "readme.txt" имеет MIME-тип "text/plain". MIME-тип может быть определен из имени файла, из содержимого файла или из обоих. Определение MIME-типа также может быть выполнено для буферов данных, не происходящих из файлов.
Определение MIME-типа файла может быть полезно, чтобы убедиться, что ваше приложение его поддерживает. Это также полезно в приложениях или виджетах, похожих на файловые менеджеры, для отображения соответствующего иконки для файла или даже описательного комментария в подробных представлениях.
Чтобы проверить, соответствует ли файл ожидаемому MIME-типу, следует использовать inherits(), а не просто сравнивать строки на основе имени. Это связано с тем, что MIME-типы могут наследоваться друг от друга: например, файл исходного кода C является типом простого текстового файла, поэтому text/x-csrc наследует text/plain.
См. также QMimeDatabase и Пример просмотрщика MIME-типов.
Документация свойств
aliases : const QStringList
Это свойство содержит список псевдонимов этого типа MIME.
Например, для text/csv возвращаемый список будет: text/x-csv, text/x-comma-separated-values.
Обратите внимание, что все экземпляры QMimeType ссылаются на правильные типы MIME, а никогда непосредственно на псевдонимы.
Порядок псевдонимов в списке не определён.
Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QStringList | aliases() const |
allAncestors : const QStringList
Это свойство содержит имена прямых и косвенных родительских типов MIME.
Возвращает все родительские типы MIME этого типа, прямые и косвенные. Это включает в себя родительские типы родительских типов и т. д.
Например, для image/svg+xml список будет: application/xml, text/plain, application/octet-stream.
Обратите внимание, что application/octet-stream является конечным родителем для всех типов файлов (но не для каталогов).
Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QStringList | allAncestors() const |
comment : const QString
Это свойство содержит описание типа MIME, которое должно отображаться в пользовательских интерфейсах.
Используется язык по умолчанию (QLocale().name()).
Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QString | comment() const |
filterString : const QString
Это свойство содержит строку фильтра, которая может быть использована в диалоге выбора файла.
Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QString | filterString() const |
genericIconName : const QString
Это свойство содержит имя файла общего значка, представляющего тип MIME.
Это следует использовать в случае, если значок, возвращённый iconName(), не найден в системе. Он используется для категорий подобных типов (например, таблицы или архивы), которые могут использовать общий значок. Спецификация именования значков freedesktop.org перечисляет набор таких имён значков.
Имя значка может быть передано в QIcon::fromTheme() для загрузки значка.
Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QString | genericIconName() const |
globPatterns : const QStringList
Это свойство содержит список шаблонов совпадения glob.
Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QStringList | globPatterns() const |
iconName : const QString
Это свойство содержит имя файла изображения значка, представляющего тип MIME.
Имя значка может быть передано в QIcon::fromTheme() для загрузки значка.
Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QString | iconName() const |
isDefault : const bool
true если этот тип MIME является типом MIME по умолчанию, который применяется ко всем файлам: application/octet-stream.
Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| bool | isDefault() const |
name : const QString
Это свойство содержит имя типа MIME.
Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QString | name() const |
parentMimeTypes : const QStringList
Это свойство содержит имена родительских типов MIME.
Тип является подклассом другого типа, если любой экземпляр первого типа также является экземпляром второго. Например, все файлы image/svg+xml также являются файлами text/xml, text/plain и application/octet-stream. Наследование относится к формату, а не к категории данных (например, нет класса «общая таблица», от которого все таблицы наследуют). И наоборот, родительским типом MIME для image/svg+xml является text/xml.
Тип MIME может иметь несколько родителей. Например, application/x-perl имеет двух родителей: application/x-executable и text/plain. Это позволяет как выполнять скрипты perl, так и открывать их в текстовых редакторах.
Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QStringList | parentMimeTypes() const |
preferredSuffix : const QString
Это свойство содержит предпочтительный суффикс для типа MIME.
Нет ведущей точки, поэтому, например, для application/pdf возвращается «pdf». Возвращаемое значение может быть пустым для типов MIME, у которых нет связанных суффиксов.
Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QString | preferredSuffix() const |
suffixes : const QStringList
Это свойство содержит известные суффиксы для типа MIME.
Нет ведущей точки, поэтому для image/jpeg возвращается «jpg», «jpeg».
Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QStringList | suffixes() const |
valid : const bool
true если объект QMimeType содержит допустимые данные, false в противном случае.
Действительный тип MIME имеет непустое name(). Недействительный тип MIME — это QMimeType по умолчанию.
Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| bool | isValid() const |
Документация функций-членов
QMimeType::QMimeType(const QMimeType &other)
Создаёт объект QMimeType как копию other.
QMimeType::QMimeType()
Создаёт объект QMimeType, инициализированный значениями свойств по умолчанию, которые указывают на недопустимый тип MIME.
QMimeType &QMimeType::operator=(QMimeType &&other)
Перемещает other в этот экземпляр QMimeType.
Эта функция была добавлена в Qt 5.2.
QMimeType &QMimeType::operator=(const QMimeType &other)
Присваивает данные other этому объекту QMimeType и возвращает ссылку на этот объект.
QMimeType::~QMimeType()
Уничтожает объект QMimeType и освобождает указатель d.
bool QMimeType::inherits(const QString &mimeTypeName) const
Возвращает true если этот тип MIME является mimeTypeName, или наследует mimeTypeName (см. parentMimeTypes()), или mimeTypeName является псевдонимом для этого типа MIME.
Этот метод доступен из QML с 5.10.
Примечание: Эта функция может быть вызвана через систему метаобъектов и из QML. См. Q_INVOKABLE.
END_OF_DOCUMENT_MARKERvoid QMimeType::swap(QMimeType &other)
Меняет местами QMimeType other с этим объектом QMimeType.
Эта операция очень быстрая и никогда не завершается с ошибкой.
Метод swap() помогает реализовать операторы присваивания безопасным способом для обработки исключений. Для получения дополнительной информации см. More C++ Idioms - Copy-and-swap.
bool QMimeType::operator!=(const QMimeType &other) const
Возвращает true если other не равно этому объекту QMimeType, в противном случае возвращает false.
bool QMimeType::operator==(const QMimeType &other) const
Возвращает true если other равно этому объекту QMimeType, в противном случае возвращает false. Имя является уникальным идентификатором для типа MIME, поэтому два типа MIME с одинаковым именем равны.
Связанные нечлен-функции
uint qHash(const QMimeType &key, uint seed = 0)
Возвращает значение хэша для key, используя seed для инициализации вычисления.
Эта функция была добавлена в Qt 5.6.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qmimetype.html