Класс QMimeType

Класс QMimeType описывает типы файлов или данных, представленные строкой MIME-типа. Подробнее...

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

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

Связанные нечлены

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

Класс QMimeType описывает типы файлов или данных, представленные строкой MIME-типа.

Например, файл с именем «readme.txt» имеет MIME-тип «text/plain». MIME-тип можно определить по имени файла, по содержимому файла или по обоим. Определение MIME-типа также можно выполнить для буферов данных, не являющихся файлами.

Определение MIME-типа файла может быть полезно для проверки поддержки вашего приложения. Это также полезно в приложениях или виджетах, подобных файловым менеджерам, для отображения соответствующего значка файла или даже описательного комментария в детальных представлениях.

Чтобы проверить, соответствует ли MIME-тип файла ожидаемому, используйте inherits(), а не просто сравнение строк на основе имени(). Это связано с тем, что MIME-типы могут наследоваться друг от друга: например, файл исходного кода C является специфическим типом простого текстового файла, поэтому text/x-csrc наследуется от text/plain.

См. также QMimeDatabase.

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

QMimeType::QMimeType()

Создаёт этот объект QMimeType, инициализируя его значениями свойств по умолчанию, которые указывают на недействительный MIME-тип.

QMimeType::QMimeType(const QMimeType &other)

Создаёт этот объект QMimeType как копию other.

QMimeType::~QMimeType()

Удаляет объект QMimeType и освобождает указатель d.

QStringList QMimeType::aliases() const

Возвращает список псевдонимов этого MIME-типа.

Например, для text/csv возвращаемый список будет: text/x-csv, text/x-comma-separated-values.

Обратите внимание, что все экземпляры QMimeType относятся к соответствующим MIME-типам, а не непосредственно к псевдонимам.

Порядок псевдонимов в списке не определён.

QStringList QMimeType::allAncestors() const

Возвращает все родительские MIME-типы этого MIME-типа, прямые и косвенные. Это включает родительские типы родительских типов и т. д.

Например, для image/svg+xml список будет: application/xml, text/plain, application/octet-stream.

Обратите внимание, что application/octet-stream является конечным родителем для всех типов файлов (но не каталогов).

QString QMimeType::comment() const

Возвращает описание MIME-типа для отображения в пользовательских интерфейсах.

Используется язык по умолчанию (QLocale().name()).

QString QMimeType::filterString() const

Возвращает строку фильтра, пригодную для диалогового окна выбора файла.

QString QMimeType::genericIconName() const

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

Это следует использовать в том случае, если значок, возвращаемый iconName(), не может быть найден в системе. Используется для категорий похожих типов (например, таблиц или архивов), которые могут использовать общий значок. Спецификация именования значков freedesktop.org перечисляет набор таких имён значков.

Имя значка можно передать в QIcon::fromTheme() для загрузки значка.

QStringList QMimeType::globPatterns() const

Возвращает список шаблонов сопоставления glob.

QString QMimeType::iconName() const

Возвращает имя файла изображения значка, представляющего MIME-тип.

Имя значка можно передать в QIcon::fromTheme() для загрузки значка.

bool QMimeType::inherits(const QString &mimeTypeName) const

Возвращает true, если этот MIME-тип является mimeTypeName или наследует mimeTypeName (см. parentMimeTypes()), или mimeTypeName является псевдонимом этого MIME-типа.

bool QMimeType::isDefault() const

Возвращает true, если этот MIME-тип является типом по умолчанию, который применяется ко всем файлам: application/octet-stream.

bool QMimeType::isValid() const

Возвращает true, если объект QMimeType содержит допустимые данные, в противном случае возвращает false. Действительный MIME-тип имеет непустое имя. Недействительный MIME-тип — это QMimeType, созданный по умолчанию.

QString QMimeType::name() const

Возвращает имя MIME-типа.

QStringList QMimeType::parentMimeTypes() const

Тип является подклассом другого типа, если любой экземпляр первого типа также является экземпляром второго. Например, все файлы 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, так и открывать их в текстовых редакторах.

QString QMimeType::preferredSuffix() const

Возвращает предпочтительное расширение для типа MIME. Не включает ведущую точку, поэтому, например, вернёт «pdf» для application/pdf. Значение возврата может быть пустым для типов MIME, у которых нет связанных расширений.

QStringList QMimeType::suffixes() const

Возвращает известные расширения для типа MIME. Не включает ведущую точку, поэтому, например, вернёт «jpg», «jpeg» для image/jpeg.

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.

QMimeType &QMimeType::operator=(const QMimeType &other)

Присваивает данные other этому объекту QMimeType и возвращает ссылку на этот объект.

QMimeType &QMimeType::operator=(QMimeType &&other)

Перемещающее присваивание other этому экземпляру QMimeType.

Эта функция была добавлена в Qt 5.2.

bool QMimeType::operator==(const QMimeType &other) const

Возвращает true если other равно этому объекту QMimeType, в противном случае возвращает false. Имя является уникальным идентификатором типа MIME, поэтому два типа MIME с одинаковым именем равны.