Класс 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-типов.
Документация по свойству
[read-only] aliases : const QStringList
Это свойство содержит список псевдонимов этого типа MIME.
Например, для text/csv, возвращаемый список будет: text/x-csv, text/x-comma-separated-values.
Обратите внимание, что все экземпляры QMimeType ссылаются на правильные типы MIME, а не на псевдонимы напрямую.
Порядок псевдонимов в списке не определён.
Хотя это свойство было добавлено в Qt 5.10, соответствующий метод доступа всегда был доступен.
Функции доступа:
| QStringList | aliases() const |
[read-only] allAncestors : const QStringList
Это свойство содержит имена непосредственных и косвенных родительских типов MIME.
Возвращает все родительские типы MIME для данного типа, прямые и косвенные. Включает родителей родителей и т.д.
Например, для image/svg+xml список будет: application/xml, text/plain, application/octet-stream.
Обратите внимание, что application/octet-stream является конечным родителем для всех типов файлов (но не для каталогов).
Хотя это свойство было добавлено в Qt 5.10, соответствующий метод доступа всегда был доступен.
Функции доступа:
| QStringList | allAncestors() const |
[read-only] comment : const QString
Это свойство содержит описание типа MIME, которое должно отображаться в пользовательских интерфейсах.
Используется язык по умолчанию (QLocale().name()), чтобы выбрать соответствующий перевод.
Хотя это свойство было добавлено в Qt 5.10, соответствующий метод доступа всегда был доступен.
Функции доступа:
| QString | comment() const |
[read-only] filterString : const QString
Это свойство содержит строку фильтра, которая может использоваться в диалогах выбора файла.
Хотя это свойство было добавлено в Qt 5.10, соответствующий метод доступа всегда был доступен.
Функции доступа:
| QString | filterString() const |
[read-only] genericIconName : const QString
Это свойство содержит имя файла универсального значка, представляющего тип MIME.
Используется, если значок, возвращаемый iconName(), не найден в системе. Используется для категорий похожих типов (таких как электронные таблицы или архивы), которые могут использовать общий значок. Спецификация именования значков freedesktop.org перечисляет набор таких имён значков.
Имя значка может быть передано в QIcon::fromTheme() для загрузки значка.
Хотя это свойство было добавлено в Qt 5.10, соответствующий метод доступа всегда был доступен.
Функции доступа:
| QString | genericIconName() const |
[read-only] globPatterns : const QStringList
Это свойство содержит список шаблонов сопоставления glob.
Хотя это свойство было добавлено в Qt 5.10, соответствующий метод доступа всегда был доступен.
Функции доступа:
| QStringList | globPatterns() const |
[read-only] iconName : const QString
Это свойство содержит имя файла изображения значка, представляющего тип MIME.
Имя значка может быть передано в QIcon::fromTheme() для загрузки значка.
Хотя это свойство было добавлено в Qt 5.10, соответствующий метод доступа всегда был доступен.
Функции доступа:
| QString | iconName() const |
[read-only] isDefault : const bool
true если этот тип MIME является типом MIME по умолчанию, который применяется ко всем файлам: application/octet-stream.
Хотя это свойство было добавлено в Qt 5.10, соответствующий метод доступа всегда был доступен.
Функции доступа:
| bool | isDefault() const |
[read-only] name : const QString
Это свойство содержит имя типа MIME.
Хотя это свойство было добавлено в Qt 5.10, соответствующий метод доступа всегда был доступен.
Функции доступа:
| QString | name() const |
[read-only] 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, так и открывать их в текстовых редакторах.
Хотя это свойство было добавлено в Qt 5.10, соответствующий метод доступа всегда был доступен.
Функции доступа:
| QStringList | parentMimeTypes() const |
[read-only] preferredSuffix : const QString
Это свойство содержит предпочтительное расширение для типа MIME.
Не включает ведущую точку, поэтому, например, для application/pdf будет возвращено «pdf». Возвращаемое значение может быть пустым для типов MIME, у которых нет связанных расширений.
Хотя это свойство было добавлено в Qt 5.10, соответствующий метод доступа всегда был доступен.
Функции доступа:
| QString | preferredSuffix() const |
[read-only] suffixes : const QStringList
Это свойство содержит известные расширения для типа MIME.
Не включает ведущую точку, поэтому для image/jpeg будет возвращено «jpg», «jpeg».
Хотя это свойство было добавлено в Qt 5.10, соответствующий метод доступа всегда был доступен.
Функции доступа:
| QStringList | suffixes() const |
[read-only] valid : const bool
true если объект QMimeType содержит действительные данные, false в противном случае.
Действительный тип MIME имеет непустое имя. Недействительный тип MIME — это QMimeType по умолчанию, созданный без параметров.
Хотя это свойство было добавлено в Qt 5.10, соответствующий метод доступа всегда был доступен.
Функции доступа:
| bool | isValid() 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.
[invokable] 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.2/qmimetype.html
