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