Класс QMimeType
Класс QMimeType описывает типы файлов или данных, представленные строкой MIME-типа. Подробнее...
| Заголовок: | #include <QMimeType> |
| CMake: | find_package(Qt6 COMPONENTS Core REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| С момента: | 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 |
Связанные нечлены
| size_t | qHash(const QMimeType &key, size_t seed = 0) |
Подробное описание
Например, файл с именем "readme.txt" имеет MIME-тип "text/plain". MIME-тип можно определить по имени файла, содержимому файла или по обоим. Определение MIME-типа также можно выполнить на буферах данных, не являющихся файлами.
Определение MIME-типа файла может быть полезным, чтобы убедиться, что ваше приложение его поддерживает. Это также полезно в приложениях или виджетах, подобных файловому менеджеру, для отображения подходящего иконки файла или даже описательного комментария в детальных представлениях.
Для проверки соответствия файла ожидаемому MIME-типу следует использовать inherits() вместо простого сравнения строк на основе имени. Это связано с тем, что MIME-типы могут наследовать друг от друга: например, файл исходного кода C является специфическим типом обычного текстового файла, поэтому text/x-csrc наследует text/plain.
См. также QMimeDatabase и Пример браузера MIME-типов.
END_OF_DOCUMENT_MARKER ```Документация свойств
[read-only] псевдонимы : const QStringList
Это свойство содержит список псевдонимов данного типа MIME.
Например, для text/csv возвращаемый список будет: text/x-csv, text/x-comma-separated-values.
Обратите внимание, что все экземпляры QMimeType ссылаются на правильные типы MIME, а не на псевдонимы напрямую.
Порядок псевдонимов в списке не определён.
Хотя это свойство было добавлено в версии 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QStringList | псевдонимы() const |
[read-only] всеПредки : const QStringList
Это свойство содержит имена непосредственных и косвенных родительских типов MIME.
Возвращает все родительские типы MIME данного типа, как прямые, так и косвенные. Это включает родителя(ей) родительского(их) типа и так далее.
Например, для image/svg+xml список будет: application/xml, text/plain, application/octet-stream.
Обратите внимание, что application/octet-stream является конечным родителем для всех типов файлов (но не для каталогов).
Хотя это свойство было добавлено в версии 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QStringList | всеПредки() const |
[read-only] комментарий : const QString
Это свойство содержит описание типа MIME, которое будет отображаться на пользовательских интерфейсах.
Используется язык по умолчанию (QLocale().name()), чтобы выбрать соответствующий перевод.
Хотя это свойство было добавлено в версии 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QString | комментарий() const |
[read-only] строкаФильтра : const QString
Это свойство содержит строку фильтра, используемую для диалогового окна выбора файла.
Хотя это свойство было добавлено в версии 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QString | строкаФильтра() const |
[read-only] имяОбщегоИконки : const QString
Это свойство содержит имя файла общей иконки, представляющей тип MIME.
Это следует использовать, если иконка, возвращаемая iconName(), не найдена в системе. Она используется для категорий похожих типов (таких как электронные таблицы или архивы), которые могут использовать общую иконку. Спецификация именования иконок freedesktop.org содержит список таких имён иконок.
Имя иконки можно передать в QIcon::fromTheme() для загрузки иконки.
Хотя это свойство было добавлено в версии 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QString | имяОбщегоИконки() const |
[read-only] шаблоныGlob : const QStringList
Это свойство содержит список шаблонов соответствия glob.
Хотя это свойство было добавлено в версии 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QStringList | шаблоныGlob() const |
[read-only] имяИконки : const QString
Это свойство содержит имя файла изображения иконки, представляющей тип MIME.
Имя иконки можно передать в QIcon::fromTheme() для загрузки иконки.
Хотя это свойство было добавлено в версии 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QString | имяИконки() const |
[read-only] являетсяПоУмолчанию : const bool
true если этот тип MIME является типом MIME по умолчанию, который применяется ко всем файлам: application/octet-stream.
Хотя это свойство было добавлено в версии 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| bool | являетсяПоУмолчанию() const |
[read-only] имя : const QString
Это свойство содержит имя типа MIME.
Хотя это свойство было добавлено в версии 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QString | имя() const |
[read-only] родительскиеТипыMIME : 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 | родительскиеТипыMIME() const |
[read-only] предпочитаемыйСуффикс : const QString
Это свойство содержит предпочтительный суффикс для типа MIME.
Впереди не включается точка, поэтому, например, для application/pdf это будет «pdf». Значение может быть пустым для типов MIME, у которых нет связанных суффиксов.
Хотя это свойство было добавлено в версии 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QString | предпочитаемыйСуффикс() const |
[read-only] суффиксы : const QStringList
Это свойство содержит известные суффиксы для типа MIME.
Впереди не включается точка, поэтому, например, для image/jpeg это будет «jpg», «jpeg».
Хотя это свойство было добавлено в версии 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| QStringList | суффиксы() const |
[read-only] действителен : const bool
true если объект QMimeType содержит действительные данные, false в противном случае.
Действительный тип MIME имеет непустое имя(). Недействительный тип MIME — это QMimeType, созданный по умолчанию.
Хотя это свойство было добавлено в версии 5.10, соответствующий метод доступа всегда был.
Функции доступа:
| bool | действителен() const |
Документация функций-членов
QMimeType::QMimeType(const QMimeType &other)
Конструирует этот объект QMimeType как копию other.
QMimeType::QMimeType()
Конструирует этот объект QMimeType, инициализированный значениями свойств по умолчанию, которые указывают на недопустимый тип MIME.
[since 5.2] 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.
void 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 с одинаковым именем равны.
Связанные Нечленные Функции
[since 5.6] size_t qHash(const QMimeType &key, size_t 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-6.0/qmimetype.html
