이 페이지에서

QMimeType Class

QMimeType 클래스는 MIME 유형 문자열로 표현되는 파일 또는 데이터의 유형을 설명합니다. 더 보기...

헤더: #include <QMimeType>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

QMimeType 비교

범주비교 가능한 유형
동등성QMimeType

속성

공개 행사

QMimeType()
QMimeType(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)
QMimeType &operator=(QMimeType &&other)
QMimeType &operator=(const QMimeType &other)
size_t qHash(const QMimeType &key, size_t seed = 0)
bool operator!=(const QMimeType &lhs, const QMimeType &rhs)
bool operator==(const QMimeType &lhs, const QMimeType &rhs)

상세 설명

예를 들어, "readme.txt"라는 파일의 MIME 유형은 "text/plain"입니다. MIME 유형은 파일 이름, 파일 내용, 또는 둘 모두를 통해 확인할 수 있습니다. 또한 파일에서 가져온 것이 아닌 데이터 버퍼에 대해서도 MIME 유형을 확인할 수 있습니다.

파일의 MIME 유형을 파악하면 애플리케이션이 해당 파일을 지원하는지 확인하는 데 유용합니다. 또한 파일 관리자 형태의 애플리케이션이나 위젯에서 파일에 적합한 icon 을 표시하거나, 상세 보기에서 설명적인 comment 을 표시하는 데에도 유용합니다.

파일이 예상된 MIME 유형을 가지고 있는지 확인하려면, name()을 기반으로 한 단순한 문자열 비교 대신 inherits()을 사용해야 합니다. 이는 MIME 유형이 서로 상속될 수 있기 때문입니다. 예를 들어, C 소스 파일은 일반 텍스트 파일의 특정 유형이므로 text/x-csrc는 text/plain을 상속받습니다.

QMimeDatabase 및 MIME Type Browser도 참조하십시오 .

속성 설명서

[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 유형의 모든 상위 MIME 유형(직접 및 간접)을 반환합니다. 여기에는 상위 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 유형에 대한 설명을 포함합니다.

사용자의 현재 언어 설정에 맞춰 현지화된 MIME 유형에 대한 설명을 반환합니다.

이 속성은 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

이 속성은 글로브 매칭 패턴 목록을 보관합니다.

이 속성은 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 파일이기도 합니다. 서브클래스 관계는 데이터의 범주가 아니라 형식에 관한 것입니다(예를 들어, 모든 스프레드시트가 상속받는 ‘일반 스프레드시트’ 클래스는 존재하지 않습니다). 반대로, image/svg+xml의 상위 MIME 유형은 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()

무효한 MIME 유형을 나타내는 기본 속성 값으로 초기화된 이 QMimeType 객체를 생성합니다.

QMimeType::QMimeType(const QMimeType &other)

other 의 복사본으로 이 QMimeType 객체를 생성합니다.

[noexcept] QMimeType::~QMimeType()

QMimeType 객체를 삭제하고, d 포인터를 해제합니다.

[invokable] bool QMimeType::inherits(const QString &mimeTypeName) const

이 MIME 유형이 mimeTypeName 이거나, mimeTypeName ( parentMimeTypes() 참조)을 상속받거나, mimeTypeName 이 이 MIME 유형의 별칭인 경우 true 을 반환합니다.

이 메서드는 5.10 버전부터 QML에서 호출할 수 있게 되었습니다.

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.

[noexcept] void QMimeType::swap(QMimeType &other)

이 MIME 유형을 other 로 교체합니다. 이 작업은 매우 빠르며 실패하는 일이 없습니다.

swap() 메서드는 예외 안전 방식으로 할당 연산자를 구현하는 데 도움이 됩니다. 자세한 내용은 『 More C++ Idioms - Copy-and-swap』을 참조하십시오.

[noexcept] QMimeType &QMimeType::operator=(QMimeType &&other)

other 를 이 QMimeType 인스턴스에 할당합니다.

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

other 의 데이터를 이 QMimeType 객체에 할당하고, 이 객체에 대한 참조를 반환합니다.

관련 비멤버

[noexcept] size_t qHash(const QMimeType &key, size_t seed = 0)

seed 를 계산의 시드로 사용하여 key 의 해시 값을 반환합니다.

[noexcept] bool operator!=(const QMimeType &lhs, const QMimeType &rhs)

QMimeType lhs 가 QMimeType rhs 와 같지 않은 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

[noexcept] bool operator==(const QMimeType &lhs, const QMimeType &rhs)

lhs 가 rhs QMimeType 객체와 동일하면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다. 이름은 MIME 유형을 식별하는 고유한 식별자이므로, 이름이 동일한 두 MIME 유형은 서로 동일합니다.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.