FolderDialog QML Type

기본 폴더 대화 상자. 더 보기...

이 유형은 Qt Labs Platform 6.9부터 더 이상 사용되지 않습니다. 새로운 코드에서는 이 유형을 사용하지 않는 것을 강력히 권장합니다.

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• acceptLabel : string
• currentFolder : url
• folder : url
• options : flags
• rejectLabel : string

상세 설명

대신 ` QtQuick.Dialogs FolderDialog `를 사용하십시오.

FolderDialog 유형은 네이티브 플랫폼 폴더 대화 상자를 위한 QML API를 제공합니다.

폴더 대화 상자를 표시하려면 FolderDialog 인스턴스를 생성하고, 원하는 속성을 설정한 다음 open()를 호출하십시오. currentFolder 속성을 사용하여 대화 상자에서 현재 선택된 폴더를 확인할 수 있습니다. folder 속성은 대화 상자를 수락하여 최종 선택이 이루어진 후에만 업데이트됩니다.

MenuItem {
    text: "Open..."
    onTriggered: folderDialog.open()
}

FolderDialog {
    id: folderDialog
    currentFolder: viewer.folder
    folder: StandardPaths.standardLocations(StandardPaths.PicturesLocation)[0]
}

MyViewer {
    id: viewer
    folder: folderDialog.folder
}

사용 가능 여부

현재 다음 플랫폼에서 네이티브 플랫폼 폴더 대화 상자를 사용할 수 있습니다:

• Android
• iOS
• Linux (GTK+ 플랫폼 테마로 실행 시)
• macOS
• Windows

Qt Labs Platform 모듈은 네이티브 구현이 제공되지 않는 플랫폼에서 Qt Widgets 를 대체 수단으로 사용합니다. 따라서 Qt Labs Platform 모듈의 타입을 사용하는 애플리케이션은 QtWidgets 에 링크해야 하며, QGuiApplication 대신 QApplication 를 사용해야 합니다.

QtWidgets 라이브러리에 링크하려면 qmake 프로젝트 파일에 다음을 추가하십시오:

QT += widgets

main() 에서 QApplication 의 인스턴스를 생성하십시오:

#include <QApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

QtQuick.Dialogs::FolderDialog, FileDialog 및 StandardPaths도 참조하십시오 .

속성 설명서

acceptLabel : string

이 속성은 대화 상자를 확인하는 버튼에 표시되는 레이블 텍스트를 지정합니다.

빈 문자열로 설정하면 기본 플랫폼의 기본 레이블이 사용됩니다. 기본 레이블은 일반적으로 ' Open'입니다.

기본값은 빈 문자열입니다.

rejectLabel도 참조하십시오 .

currentFolder : url

이 속성은 대화 상자에서 현재 선택된 폴더를 저장합니다.

folder 속성과 달리, currentFolder 속성은 사용자가 대화 상자에서 폴더를 선택하는 동안, 최종 선택이 이루어지기 전이라도 업데이트됩니다.

folder도 참조하십시오 .

folder : url

이 속성은 최종적으로 선택된 폴더를 저장합니다.

currentFolder 속성과 달리, folder 속성은 사용자가 대화 상자에서 폴더를 선택하는 동안에는 업데이트되지 않고, 최종 선택이 완료된 후에만 업데이트됩니다. 즉, 사용자가 ' OK '를 클릭하여 폴더를 승인했을 때입니다. 또는 accepted() 신호를 처리하여 최종 선택 결과를 얻을 수도 있습니다.

currentFolder 및 accepted()도 참조하십시오 .

options : flags

이 속성은 대화 상자의 모양과 느낌에 영향을 미치는 다양한 옵션을 포함합니다.

기본적으로 모든 옵션은 비활성화되어 있습니다.

옵션은 대화 상자를 표시하기 전에 설정해야 합니다. 대화 상자가 표시된 상태에서 옵션을 설정하더라도 대화 상자에 즉시 반영된다는 보장은 없습니다(옵션 및 플랫폼에 따라 다름).

사용 가능한 옵션:

rejectLabel : string

이 속성은 대화 상자를 닫는 버튼에 표시되는 레이블 텍스트를 지정합니다.

빈 문자열로 설정하면 기본 플랫폼의 기본 레이블이 사용됩니다. 기본 레이블은 일반적으로 ' Cancel'입니다.

기본값은 빈 문자열입니다.

acceptLabel도 참조하십시오 .