FileDialog QML Type

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

この型はQt.labs.platform 6.9から非推奨となりました。新しいコードでは使用しないことを強くお勧めします。

• 継承されたメンバを含む、すべてのメンバのリスト

プロパティ

• acceptLabel : string
• currentFile : url
• currentFiles : list<url>
• defaultSuffix : string
• file : url
• fileMode : enumeration
• files : list<url>
• folder : url
• nameFilters : list<string>
• options : flags
• rejectLabel : string
• selectedNameFilter
  • selectedNameFilter.extensions : list<string>
  • selectedNameFilter.index : int
  • selectedNameFilter.name : string

詳細説明

代わりにQtQuick.Dialogs FileDialog を使ってください。

FileDialog型は、ネイティブプラットフォームのファイルダイアログのための QML APIを提供します。

ファイルダイアログを表示するには、FileDialogのインスタンスを作成し、必要なプロパティを設定し、open （）を呼び出します。currentFile またはcurrentFiles プロパティは、ダイアログ内で現在選択されているファイルを決定するために使用することができます。file およびfiles プロパティは、ダイアログを受け入れることによって最終的な選択が行われた後にのみ更新されます。

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

FileDialog {
    id: fileDialog
    currentFile: document.source
    folder: StandardPaths.writableLocation(StandardPaths.DocumentsLocation)
}

MyDocument {
    id: document
    source: fileDialog.file
}

利用可能性

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

• アンドロイド
• iOS
• Linux（GTK+プラットフォームテーマで動作している場合）
• macOS
• Windows

Qt Labs Platform モジュールは、ネイティブ実装が利用できないプラットフォームでは、フォールバックとしてQt Widgets を使用します。したがって、Qt Labs Platform モジュールの型を使用するアプリケーションは、QtWidgets にリンクし、QGuiApplication の代わりにQApplication を使用する必要があります。

QtWidgets ライブラリにリンクするには、qmake プロジェクト・ファイルに以下を追加します：

QT += widgets

main() にQApplication のインスタンスを作成します：

#include <QApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

QtQuick.Dialogs::FileDialog 、FolderDialog 、StandardPathsも参照して ください。

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

acceptLabel : string

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

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

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

rejectLabelも参照してください 。

currentFile : url

このプロパティは、ダイアログ内で現在選択されているファイルを保持する。

file プロパティとは異なり、currentFile プロパティは、ユーザがダイアログ内でファイルを選択している間、最終的な選択が行われる前であっても更新されます。

file およびcurrentFilesも参照してください 。

currentFiles : list<url>

このプロパティは、ダイアログ内で現在選択されているファイルを保持する。

files プロパティとは異なり、currentFiles プロパティは、ユーザがダイアログ内でファイルを選択している間、最終的な選択が行われる前であっても更新されます。

files およびcurrentFileも参照してください 。

defaultSuffix : string

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

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

file : url

このプロパティは、最終的に受け入れられたファイルを保持する。

currentFile プロパティとは異なり、file プロパティは、ユーザがダイアログでファイルを選択している間は更新されず、最終的な選択が行われた後にのみ更新されます。つまり、ユーザがOK をクリックしてファイルを受け入れたときである。あるいは、accepted() シグナルを処理して、最終的な選択を取得することもできます。

currentFile およびaccepted()も参照の こと。

fileMode : enumeration

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

利用可能な値

files : list<url>

このプロパティは、最終的に受け入れられたファイルを保持する。

currentFiles プロパティとは異なり、files プロパティは、ユーザがダイアログでファイルを選択している間は更新されず、最終的な選択が行われた後にのみ更新されます。つまり、ユーザがOK をクリックしてファイルを受け入れたときである。あるいは、accepted() シグナルを処理して、最終選択を取得することもできます。

currentFiles およびaccepted()も参照のこと 。

folder : url

このプロパティは、ファイルを選択するフォルダを保持します。フォルダを選択するには、代わりに FolderDialog を使用します。

FolderDialogも参照してください 。

nameFilters : list<string>

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

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

selectedNameFilterも参照して ください。

options : flags

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

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

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

利用可能なオプション

rejectLabel : string

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

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

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

acceptLabelも参照してください 。

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も参照してください 。