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
}

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

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

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