Тип QML FolderDialog

Диалог выбора папки. Подробнее...

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

Свойства

• acceptLabel : строка
• currentFolder : url
• folder : url
• options : флаги
• rejectLabel : строка

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

Тип 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
}

Доступность

Диалог выбора папки нативной платформы в настоящее время доступен на следующих платформах:

• iOS
• Linux (при запуске с темой платформы GTK+)
• macOS
• Windows
• WinRT

Модуль Qt Labs Platform использует Qt Widgets в качестве резервного варианта на платформах, где нет нативного имплементации. Поэтому приложения, использующие типы из модуля Qt Labs Platform, должны связываться с QtWidgets и использовать QApplication вместо QGuiApplication.

Для связывания с библиотекой QtWidgets добавьте следующее в ваш файл проекта qmake:

QT += widgets

Создайте экземпляр QApplication в main():

#include <QApplication>
#include <QQmlApplicationEngine>

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

Примечание: Типы в модулях Qt.labs не гарантируют совместимость в будущих версиях.

См. также FileDialog и StandardPaths.

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

acceptLabel : строка

Это свойство содержит текст метки, отображаемой на кнопке подтверждения диалога.

При установке в пустую строку используется метка по умолчанию для соответствующей платформы. Метка по умолчанию обычно Открыть.

Значение по умолчанию — пустая строка.

См. также rejectLabel.

currentFolder : url

Это свойство содержит текущую выбранную папку в диалоге.

В отличие от свойства folder, свойство currentFolder обновляется, пока пользователь выбирает папки в диалоге, даже до окончательного выбора.

См. также folder.

folder : url

Это свойство содержит окончательно принятую папку.

В отличие от свойства currentFolder, свойство folder обновляется только после окончательного выбора, когда пользователь нажимает ОК, чтобы принять папку. В качестве альтернативы, можно обработать сигнал accepted() для получения окончательного выбора.

См. также currentFolder и accepted().

options : флаги

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

По умолчанию все параметры отключены.

Параметры должны быть установлены до показа диалога. Их установка во время отображения диалога не гарантирует немедленного эффекта (в зависимости от параметра и платформы).

Доступные параметры:

rejectLabel : строка

Это свойство содержит текст метки, отображаемой на кнопке отмены диалога.

При установке в пустую строку используется метка по умолчанию для соответствующей платформы. Метка по умолчанию обычно Отмена.

Значение по умолчанию — пустая строка.

См. также acceptLabel.