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
    }
}

利用可能性

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

• アンドロイド
• 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も参照してください 。