QQmlFileSelector Class
QML 파일 로딩 시 QFileSelector 을 적용하는 클래스입니다. 더 보기...
| 헤더: | #include <QQmlFileSelector> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Qml) target_link_libraries(mytarget PRIVATE Qt6::Qml) |
| qmake: | QT += qml |
| 상속: | QObject |
공개 함수
| QQmlFileSelector(QQmlEngine *engine, QObject *parent = nullptr) | |
| virtual | ~QQmlFileSelector() override |
| QFileSelector * | selector() const |
| void | setExtraSelectors(const QStringList &strings) |
| void | setSelector(QFileSelector *selector) |
상세 설명
QQmlFileSelector는 qml 파일 및 자산 경로에 ` QFileSelector `를 자동으로 적용합니다.
사용 방법은 다음과 같습니다:
QQmlEngine engine;
QQmlFileSelector* selector = new QQmlFileSelector(&engine);그러면 다음과 같이 파일을 교체할 수 있습니다:
main.qml
Component.qml
asset.png
+unix/Component.qml
+mac/asset.png이 예제에서 main.qml은 일반적으로 Component 유형에 대해 Component.qml을 사용합니다. 하지만 유닉스 플랫폼에서는 유닉스 선택기가 존재하므로 대신 +unix/Component.qml 버전이 사용됩니다. 이는 Component.qml을 +unix/Component.qml로 교체하는 것과 같은 효과를 내므로, Component.qml을 사용할 때는 선택된 버전에 따라 경로를 수정할 필요가 없습니다.
예를 들어, "asset.png" 파일 경로를 전달하려면 main.qml, Component.qml, +linux/Component.qml 전체에서 모두 단순히 "asset.png"로 참조하면 됩니다. 모든 경우에 Mac 플랫폼에서는 +mac/asset.png로 대체됩니다.
사용 가능한 선택자 목록은 QFileSelector 을 참조하십시오.
사용하는 플랫폼에서 사용할 수 있는 추가 선택기도 제공될 수 있습니다. QFileSelector 에 명시된 바와 같이, 선택에 사용되는 디렉터리는 '+' 문자로 시작해야 하므로, 프로젝트 내에 해당 이름의 디렉터리가 없는 한 실수로 이 기능을 실행하는 일은 없습니다.
엔진에 새로운 QQmlFileSelector가 설정되면 기존 선택기는 대체됩니다.
멤버 함수 문서
[explicit] QQmlFileSelector::QQmlFileSelector(QQmlEngine *engine, QObject *parent = nullptr)
parent 를 상위 객체로 하는 새로운 QQmlFileSelector를 생성하며, 여기에는 자체적인 QFileSelector 가 포함됩니다. engine 는 파일 선택기를 적용하려는 QQmlEngine 입니다. 또한 이 객체는 QQmlFileSelector에 대한 소유권을 인수합니다.
[override virtual noexcept] QQmlFileSelector::~QQmlFileSelector()
QQmlFileSelector 객체를 삭제합니다.
[noexcept] QFileSelector *QQmlFileSelector::selector() const
QQmlFileSelector 에서 사용하는 QFileSelector 인스턴스를 반환합니다.
setSelector()도 참조하십시오 .
void QQmlFileSelector::setExtraSelectors(const QStringList &strings)
strings 에 포함된 추가 선택자를 현재 사용 중인 QFileSelector 에 추가합니다. 추가 선택자만 필요하고, 직접 QFileSelector 인스턴스를 생성할 필요가 없을 때 이 방법을 사용하세요.
void QQmlFileSelector::setSelector(QFileSelector *selector)
QQmlFileSelector 가 사용할 QFileSelector 인스턴스를 selector 로 설정합니다. QQmlFileSelector 는 새로운 QFileSelector 에 대한 소유권을 인수하지 않습니다. QQmlFileSelector 가 내부 QFileSelector 인스턴스를 사용하도록 재설정하려면 setSelector(nullptr)를 호출하십시오.
selector()도 참조하십시오 .
© 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.
