FolderDialog QML Type
ネイティブのフォルダダイアログ。詳細...
Import Statement: | import Qt.labs.platform |
Inherits: | |
Status: | Deprecated since 6.9 |
この型は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(); }
注意: Qt.labs モジュールの型は、将来のバージョンでも互換性が保たれることを保証するものではありません。
QtQuick.Dialogs::FolderDialog 、FileDialog 、StandardPathsも参照して ください。
プロパティ Documentation
acceptLabel : string |
このプロパティは、ダイアログを受け入れるボタンに表示されるラベルテキストを保持します。
空文字列に設定されると、基礎となるプラットフォームのデフォルトラベルが使用されます。デフォルトのラベルは通常Open である。
デフォルト値は空文字列です。
rejectLabelも参照してください 。
currentFolder : url |
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.