Spec-Zone.ru › Qt 5.13

Класс QMimeType

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

Заголовок: #include <QMimeType>
qmake: QT += core
С момента: Qt 5.0

Этот класс был представлен в Qt 5.0.

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

Свойства

  • aliases : const QStringList
  • allAncestors : const QStringList
  • comment : const QString
  • filterString : const QString
  • genericIconName : const QString
  • globPatterns : const QStringList
  • iconName : const QString
  • isDefault : const bool
  • name : const QString
  • parentMimeTypes : const QStringList
  • preferredSuffix : const QString
  • suffixes : const QStringList
  • valid : const bool

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

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

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

uint qHash(const QMimeType &key, uint seed = 0)

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

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

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

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

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

Документация по свойствам

aliases : const QStringList

Это свойство содержит список псевдонимов данного типа MIME.

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

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

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

Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.

Функции доступа:

QStringList aliases() const

allAncestors : const QStringList

Это свойство содержит имена прямых и косвенных родительских типов MIME.

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

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

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

Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.

Функции доступа:

QStringList allAncestors() const

comment : const QString

Это свойство содержит описание типа MIME, которое будет отображаться в пользовательских интерфейсах.

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

Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.

Функции доступа:

QString comment() const

filterString : const QString

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

Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.

Функции доступа:

QString filterString() const

genericIconName : const QString

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

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

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

Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.

Функции доступа:

QString genericIconName() const

globPatterns : const QStringList

Это свойство содержит список шаблонов сопоставления glob.

Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.

Функции доступа:

QStringList globPatterns() const

iconName : const QString

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

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

Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.

Функции доступа:

QString iconName() const

isDefault : const bool

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

Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.

Функции доступа:

bool isDefault() const

name : const QString

Это свойство содержит имя типа MIME.

Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.

Функции доступа:

QString name() const

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

preferredSuffix : const QString

Это свойство содержит предпочтительное расширение для типа MIME.

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

Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.

Функции доступа:

QString preferredSuffix() const

suffixes : const QStringList

Это свойство содержит известные расширения для типа MIME.

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

Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.

Функции доступа:

QStringList suffixes() const

valid : const bool

true если объект QMimeType содержит допустимые данные, false в противном случае

Действительный тип MIME имеет непустое имя. Недействительный тип MIME — это QMimeType по умолчанию.

Хотя это свойство было добавлено в 5.10, соответствующий метод доступа всегда был.

Функции доступа:

bool isValid() const

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

QMimeType::QMimeType(const QMimeType &other)

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

QMimeType::QMimeType()

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

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 с одинаковым именем равны.

Связанные нечленные функции

uint QMimeType::qHash(const QMimeType &key, uint 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-5.13/qmimetype.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API