Класс QMimeType

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

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

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

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

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

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

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

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

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

См. также QMimeDatabase и Пример обозревателя типов MIME.

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

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-тип является 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. Лидирующая точка не включается, поэтому, например, для application/pdf будет возвращено «pdf». Возвращаемое значение может быть пустым для типов MIME, для которых не определены расширения.

QStringList QMimeType::suffixes() const

Возвращает известные расширения для типа MIME. Лидирующая точка не включается, поэтому, например, для image/jpeg будет возвращено «jpg», «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 с одинаковым именем равны.