FolderDialog QML Type

ネイティブのフォルダダイアログ。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

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

詳細な説明

FolderDialog タイプは、ネイティブプラットフォームのフォルダダイアログ用の QML API を提供します。

フォルダダイアログを表示するには、FolderDialogのインスタンスを作成し、必要なプロパティを設定した上で、open()を呼び出します。currentFolder プロパティを使用すると、ダイアログに現在表示されているフォルダを確認できます。selectedFolder プロパティを使用すると、ダイアログで最後に選択されたフォルダを確認できます。

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

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

MyViewer {
    id: viewer
    folder: folderDialog.selectedFolder
}

利用可能プラットフォーム

ネイティブのプラットフォーム用フォルダダイアログは、現在以下のプラットフォームで利用可能です：

• Android
• iOS
• Linux（GTK+プラットフォームテーマで実行している場合）
• macOS
• Windows

Qt Quick Dialogs は、ネイティブの実装が利用できないプラットフォームにおいて、Qt Quick の実装をフォールバックとして使用します。

「 FileDialog 」および「StandardPaths 」も参照してください 。

プロパティのドキュメント

acceptLabel : string

このプロパティには、ダイアログを承認するボタンに表示されるラベルテキストが格納されます。

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

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

「rejectLabel」も参照してください 。

currentFolder : url

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

「selectedFolder」も参照してください 。

options : flags

このプロパティには、ダイアログの外観や動作に影響を与えるさまざまなオプションが格納されています。

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

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

利用可能なオプション：

rejectLabel : string

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

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

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

「acceptLabel」も参照してください 。

selectedFolder : url

このプロパティには、ダイアログで最後に選択されたフォルダが格納されます。

このプロパティの値は、ユーザーがダイアログでフォルダを選択するたびに、およびダイアログが承認された際に更新されます。あるいは、accepted() シグナルを処理することで、最終的な選択内容を取得することもできます。

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