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) |
상세 설명
QQml파일선택기는 qml 파일 및 에셋 경로에 QFileSelector 을 자동으로 적용합니다.
다음과 같이 사용됩니다:
QQmlEngine engine; QQmlFileSelector* selector = new QQmlFileSelector(&engine);
다음과 같이 파일을 교체할 수 있습니다:
main.qml Component.qml asset.png +unix/Component.qml +mac/asset.png
이 예제에서 main.qml은 일반적으로 컴포넌트 유형에 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)
자체 QFileSelector 을 포함하는 부모 객체 parent 를 가진 새 QQmlFileSelector를 생성합니다. 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()도 참조하세요 .
© 2025 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.
