FileDialog QML Type

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

空文字列に設定されると、基礎となるプラットフォームのデフォルトラベルが使用されます。デフォルトのラベルは、ダイアログがどのfileMode で使用されているかによって、通常Open またはSave です。

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

rejectLabelも参照 。

このプロパティは、ファイルが選択されるフォルダを保持します。ダイアログを開いたときに表示される初期ディレクトリを制御するために設定することができます。

フォルダの選択には、代わりにFolderDialog を使用する。

このプロパティは、接尾辞が指定されていない選択されたファイルに追加される接尾辞を保持します。接尾辞は通常、ファイルタイプを示すために使用されます（例えば、"txt "はテキストファイルを示します）。

最初の文字がドット('.')の場合、ドットは削除されます。

このプロパティは、ダイアログのモードを保持します。

利用可能な値

このプロパティは、選択できるファイルのタイプを制限するフィルタを保持します。

FileDialog {
    nameFilters: ["Text files (*.txt)", "HTML files (*.html *.htm)"]
}

プラットフォームが異なると、選択できるファイルが異なる方法で制限されることがあります。例えば、macOSはフィルターに一致しないファイルエントリーを無効にしますが、Windowsは非表示にします。

selectedNameFilterも参照してください 。

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

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

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

利用可能なオプション

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

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

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

acceptLabelも参照してください 。

このプロパティは、ダイアログで最後に選択されたファイルを保持します。

ダイアログを開いたときに選択されるファイルを制御するために設定することができます。

選択されたファイルが複数ある場合、このプロパティは最初のファイルを参照する。

このプロパティの値は、ユーザーがダイアログでファイルを選択するたびに更新され、ダイアログが受け入れられたときに更新されます。accepted() シグナルを処理して、最終的な選択を取得する。

selectedFiles 、accepted()、currentFolderも参照 。

このプロパティは、ダイアログで最後に選択されたファイルを保持する。

このプロパティの値は、ユーザがダイアログ内でファイルを選択するたびに更新され、ダイアログが受理されると更新されます。accepted() シグナルを処理して、最終的な選択内容を取得します。

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

これらのプロパティは、現在選択されている名前フィルタを保持します。

FileDialog {
    id: fileDialog
    selectedNameFilter.index: 1
    nameFilters: ["Text files (*.txt)", "HTML files (*.html *.htm)"]
}

MyDocument {
    id: document
    fileType: fileDialog.selectedNameFilter.extensions[0]
}

nameFiltersも参照してください 。