FolderDialog QML Type

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

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

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

プロパティ

• acceptLabel : string
• currentFolder : url
• folder : url
• options : flags
• rejectLabel : string

詳細説明

代わりにQtQuick.Dialogs FolderDialog を使用してください。

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

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

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

FolderDialog {
    id: folderDialog
    currentFolder: viewer.folder
    folder: StandardPaths.standardLocations(StandardPaths.PicturesLocation)[0]
}

MyViewer {
    id: viewer
    folder: folderDialog.folder
}

利用可能性

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

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

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

acceptLabel : string

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

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

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

rejectLabelも参照してください 。

currentFolder : url

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

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

folderも参照してください 。

folder : url

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

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

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

options : flags

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

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

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

利用可能なオプション

rejectLabel : string

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

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

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

acceptLabelも参照してください 。