Back to Qt.io
Contact Us Blog Download Qt

FolderDialog QML Type

ネイティブのフォルダダイアログ。さらに...

Import Statement: import Qt.labs.platform
Inherits:

Dialog

プロパティ

詳細な説明

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();
}

注意: Qt.labs モジュールの型は、将来のバージョンでも互換性が保たれることを保証するものではありません。

FileDialog とStandardPathsも参照して ください。

プロパティ Documentation

acceptLabel : string

このプロパティは、ダイアログを受け入れるボタンに表示されるラベルテキストを保持します。

空文字列に設定すると、基本プラットフォームのデフォルトラベルが使用されます。デフォルトのラベルは通常Open です。

デフォルト値は空文字列です。

rejectLabelも参照してください 。


currentFolder : url

このプロパティは、ダイアログで現在選択されているフォルダを保持します。

folder プロパティとは異なり、currentFolder プロパティは、ユーザーがダイアログでフォルダを選択している間、最終的な選択が行われる前であっても更新されます。

folderも参照してください 。


folder : url

このプロパティは、最終的に受け入れられたフォルダを保持します。

currentFolder プロパティとは異なり、folder プロパティは、ユーザーがダイアログでフォルダを選択している間は更新されず、最終選択が行われた後にのみ更新されます。つまり、ユーザーがOK をクリックしてフォルダを選択したときです。あるいは、accepted() シグナルを処理して、最終的な選択を取得することもできます。

currentFolder およびaccepted()も参照してください 。


options : flags

このプロパティは、ダイアログのルック＆フィールに影響する様々なオプションを保持します。

デフォルトでは、すべてのオプションは無効になっています。

オプションはダイアログを表示する前に設定する必要があります。ダイアログが表示されている間にオプションを設定しても、ダイアログに即座に反映されるとは限りません（オプションやプラットフォームによって異なります）。

利用可能なオプション

定数説明
FolderDialog.ShowDirsOnlyフォルダダイアログでディレクトリのみを表示します。デフォルトでは、フォルダとディレクトリの両方が表示されます。
FolderDialog.DontResolveSymlinksフォルダダイアログでシンボリックリンクを解決しない。デフォルトでは、シンボリックリンクは解決されます。
FolderDialog.ReadOnlyダイアログでディレクトリの作成が許可されていないことを示します。

rejectLabel : string

このプロパティは、ダイアログを拒否するボタンに表示されるラベルテキストを保持します。

空文字列に設定すると、基礎となるプラットフォームのデフォルトのラベルが使用されます。デフォルトのラベルは通常Cancel です。

デフォルト値は空文字列です。

acceptLabelも参照してください 。


© 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.