FileDialog QML Type

ファイル選択ダイアログ。詳細...

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

プロパティ

• acceptLabel : string
• currentFolder : url
• defaultSuffix : string
• fileMode : enumeration
• nameFilters : list<string>
• options : flags
• rejectLabel : string
• selectedFile : url
• selectedFiles : list<url>
• selectedNameFilter
  • selectedNameFilter.extensions : list<string>
  • selectedNameFilter.globs : list<string>
  • selectedNameFilter.index : int
  • selectedNameFilter.name : string

詳細な説明

FileDialog 型は、ファイルダイアログ用の QML API を提供します。

ファイルダイアログを表示するには、FileDialogのインスタンスを作成し、必要なプロパティを設定してから、open()を呼び出します。currentFolder プロパティを使用すると、ダイアログが開くフォルダを指定できます。selectedFile およびselectedFiles プロパティは、ダイアログが開かれたときにどのファイルが選択されるかを指定するために使用でき、ユーザーがダイアログ内でファイルを選択したときや、ダイアログが承認されたときにも更新されます。

import QtCore
import QtQuick
import QtQuick.Controls
import QtQuick.Dialogs

ApplicationWindow {
    width: 640
    height: 480
    visible: true

    header: ToolBar {
        Button {
            text: qsTr("Choose Image...")
            onClicked: fileDialog.open()
        }
    }

    Image {
        id: image
        anchors.fill: parent
        fillMode: Image.PreserveAspectFit
    }

    FileDialog {
        id: fileDialog
        currentFolder: StandardPaths.standardLocations(StandardPaths.PicturesLocation)[0]
        onAccepted: image.source = selectedFile
    }
}

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

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

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

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

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

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

acceptLabel : string

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

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

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

rejectLabelも参照してください 。

currentFolder : url

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

フォルダを選択するには、代わりに `FolderDialog ` を使用してください。

defaultSuffix : string

このプロパティには、拡張子が指定されていない選択されたファイルに追加される拡張子が設定されます。この拡張子は通常、ファイルの種類を示すために使用されます（例：「txt」はテキストファイルを示します）。

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

fileMode : enumeration

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

使用可能な値：

nameFilters : list<string>

このプロパティには、選択可能なファイルの種類を制限するフィルタが設定されています。

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

プラットフォームによって、選択可能なファイルの制限方法が異なる場合があります。たとえば、macOSではフィルタに一致しないファイルエントリが無効化されるのに対し、Windowsでは非表示になります。

selectedNameFilterも参照してください 。

options : flags

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

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

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

利用可能なオプション：

rejectLabel : string

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

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

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

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

selectedFile : url

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

このプロパティを設定することで、ダイアログが開かれた際に選択されるファイルを制御できます。

複数のファイルが選択されている場合、このプロパティは最初のファイルを指します。

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

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

selectedFiles : list<url>

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

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

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

selectedNameFilter group

これらのプロパティには、現在選択されている名前フィルターが格納されています。

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

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

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