FolderDialog QML Type
ネイティブのフォルダダイアログ。詳細...
| Import Statement: | import QtQuick.Dialogs |
| Since: | Qt 6.3 |
| Inherits: |
プロパティ
- 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も参照して ください。
プロパティ Documentation
acceptLabel : string |
このプロパティは、ダイアログを受け入れるボタンに表示されるラベルテキストを保持します。
空文字列に設定された場合、基礎となるプラットフォームのデフォルトラベルが使用されます。デフォルトのラベルは通常Open です。
デフォルト値は空文字列です。
rejectLabelも参照してください 。
currentFolder : url |
このプロパティは、ダイアログで現在表示されているフォルダを保持します。
selectedFolder も参照 。
options : flags |
このプロパティは、ダイアログのルック＆フィールに影響する様々なオプションを保持します。
デフォルトでは、すべてのオプションは無効になっています。
オプションはダイアログを表示する前に設定する必要があります。ダイアログが表示されている間にオプションを設定しても、ダイアログにすぐに効果があるとは限りません（オプションやプラットフォームによって異なります）。
利用可能なオプション
| 定数 | 説明 |
|---|---|
FolderDialog.DontResolveSymlinks | フォルダダイアログでシンボリックリンクを解決しない。デフォルトではシンボリックリンクは解決されます。 |
FolderDialog.ReadOnly | ダイアログでディレクトリを作成できないことを示します。 |
FolderDialog.DontUseNativeDialog | 非ネイティブのクイック実装を使用するようにダイアログを強制します。 |
rejectLabel : string |
このプロパティは、ダイアログを拒否するボタンに表示されるラベルテキストを保持します。
空文字列に設定された場合、基礎となるプラットフォームのデフォルトラベルが使用されます。デフォルトのラベルは通常Cancel です。
デフォルト値は空文字列です。
acceptLabelも参照してください 。
selectedFolder : url |
このプロパティは、ダイアログで最後に選択されたフォルダを保持します。
このプロパティの値は、ユーザーがダイアログでフォルダを選択するたびに、またダイアログが受け入れられたときに更新されます。あるいは、accepted() シグナルを処理して、最終的な選択内容を取得することもできます。
currentFolder およびaccepted()も参照してください 。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
