QFileDialog::directoryUrl()を使ってディレクトリを選択する方法

Qt WidgetsにおけるQFileDialog::directoryUrl()の解説

機能概要

• ユーザーにディレクトリ選択ダイアログを表示します。
• 選択されたディレクトリのURLをQUrlオブジェクトとして返します。
• ダイアログのオプションをカスタマイズできます。

使用例

#include <QtWidgets/QFileDialog>
#include <QUrl>

int main() {
  // ファイルダイアログを作成
  QFileDialog dialog;

  // ダイアログのタイトルを設定
  dialog.setWindowTitle("ディレクトリを選択してください");

  // 初期ディレクトリを設定
  dialog.setDirectoryUrl(QUrl::fromLocalFile("/home/user"));

  // ファイル選択モードをディレクトリ選択に設定
  dialog.setFileMode(QFileDialog::Directory);

  // ダイアログを表示
  if (dialog.exec() == QDialog::Accepted) {
    // 選択されたディレクトリのURLを取得
    QUrl directoryUrl = dialog.selectedUrls().first();

    // 選択されたディレクトリを表示
    qDebug() << "選択されたディレクトリ：" << directoryUrl.toString();
  }

  return 0;
}

オプションのカスタマイズ

• 初期ディレクトリ: setDirectoryUrl()
• フィルタ: setNameFilters()
• 表示オプション: setViewMode()
• 選択モード: setFileMode()

詳細はQtドキュメントのQFileDialog::directoryUrl(): [無効な URL を削除しました]。

補足

• QFileDialog::getExistingDirectory()は、QFileDialog::directoryUrl()と似ていますが、既存のディレクトリのみを選択できます。
• QFileDialog::getOpenFileName() and QFileDialog::getSaveFileName()は、ファイルを選択するための関数です。

質問

QFileDialog::directoryUrl() のサンプルコード集

初期ディレクトリとフィルタ

#include <QtWidgets/QFileDialog>
#include <QUrl>

int main() {
  // ファイルダイアログを作成
  QFileDialog dialog;

  // 初期ディレクトリを設定
  dialog.setDirectoryUrl(QUrl::fromLocalFile("/home/user/Pictures"));

  // フィルタを設定
  dialog.setNameFilters({"*.jpg", "*.png"});

  // ダイアログを表示
  if (dialog.exec() == QDialog::Accepted) {
    // 選択されたファイルのURLを取得
    QUrl fileUrl = dialog.selectedUrls().first();

    // 選択されたファイルを表示
    qDebug() << "選択されたファイル：" << fileUrl.toString();
  }

  return 0;
}

詳細オプション

#include <QtWidgets/QFileDialog>
#include <QUrl>

int main() {
  // ファイルダイアログを作成
  QFileDialog dialog;

  // 詳細オプションを設定
  dialog.setOptions(QFileDialog::DontUseNativeDialog | QFileDialog::ShowDirsOnly);

  // ダイアログを表示
  if (dialog.exec() == QDialog::Accepted) {
    // 選択されたディレクトリのURLを取得
    QUrl directoryUrl = dialog.selectedUrls().first();

    // 選択されたディレクトリを表示
    qDebug() << "選択されたディレクトリ：" << directoryUrl.toString();
  }

  return 0;
}

複数選択

#include <QtWidgets/QFileDialog>
#include <QUrl>

int main() {
  // ファイルダイアログを作成
  QFileDialog dialog;

  // 複数選択を許可
  dialog.setAcceptMode(QFileDialog::AcceptOpen);

  // ダイアログを表示
  if (dialog.exec() == QDialog::Accepted) {
    // 選択されたファイルのURLリストを取得
    QList<QUrl> fileUrls = dialog.selectedUrls();

    // 選択されたファイルを表示
    for (const QUrl& fileUrl : fileUrls) {
      qDebug() << "選択されたファイル：" << fileUrl.toString();
    }
  }

  return 0;
}

カスタムウィジェット

#include <QtWidgets/QFileDialog>
#include <QtWidgets/QVBoxLayout>
#include <QtWidgets/QPushButton>
#include <QUrl>

class MyDialog : public QDialog {
  Q_OBJECT
public:
  MyDialog() {
    // レイアウトを作成
    QVBoxLayout* layout = new QVBoxLayout(this);

    // プッシュボタンを作成
    QPushButton* button = new QPushButton("ディレクトリを選択");

    // ボタンクリック時の処理
    connect(button, &QPushButton::clicked, [this]() {
      // ファイルダイアログを作成
      QFileDialog dialog;

      // ダイアログを表示
      if (dialog.exec() == QDialog::Accepted) {
        // 選択されたディレクトリのURLを取得
        QUrl directoryUrl = dialog.selectedUrls().first();

        // 選択されたディレクトリを表示
        qDebug() << "選択されたディレクトリ：" << directoryUrl.toString();
      }
    });

    // レイアウトに追加
    layout->addWidget(button);
  }
};

int main() {
  // アプリケーションを作成
  QApplication app(argc, argv);

  // ダイアログを作成
  MyDialog dialog;

  // ダイアログを表示
  dialog.show();

  return app.exec();
}

まとめ

QFileDialog::directoryUrl() 以外のディレクトリ選択方法

QFileSystemModel は、ファイルシステムをモデル化するクラスです。このモデルを使用して、ディレクトリツリーを表示し、ユーザーがディレクトリを選択できるようにできます。

#include <QtWidgets/QTreeView>
#include <QtWidgets/QFileSystemModel>

int main() {
  // ファイルシステムモデルを作成
  QFileSystemModel model;

  // モデルをツリービューに設定
  QTreeView treeView;
  treeView.setModel(&model);

  // ルートディレクトリを設定
  model.setRootPath(QUrl::fromLocalFile("/home/user"));

  // ツリービューを表示
  treeView.show();

  // ユーザーがディレクトリを選択するのを待つ
  // ...

  // 選択されたディレクトリを取得
  QModelIndex index = treeView.currentIndex();
  QUrl directoryUrl = model.data(index, Qt::UserRole).toUrl();

  // 選択されたディレクトリを表示
  qDebug() << "選択されたディレクトリ：" << directoryUrl.toString();

  return 0;
}

QLineEdit は、テキスト編集用のラインエディットウィジェットです。このウィジェットを使用して、ユーザーが入力したディレクトリパスを受け取ることができます。

#include <QtWidgets/QLineEdit>
#include <QPushButton>

int main() {
  // ラインエディットを作成
  QLineEdit lineEdit;

  // プッシュボタンを作成
  QPushButton* button = new QPushButton("選択");

  // ボタンクリック時の処理
  connect(button, &QPushButton::clicked, [&]() {
    // 入力されたディレクトリパスを取得
    QString directoryPath = lineEdit.text();

    // ディレクトリが存在するかどうかをチェック
    if (QDir(directoryPath).exists()) {
      // 選択されたディレクトリを表示
      qDebug() << "選択されたディレクトリ：" << directoryPath;
    } else {
      // エラーメッセージを表示
      qDebug() << "ディレクトリが存在しません：" << directoryPath;
    }
  });

  // レイアウトを作成
  QHBoxLayout layout;
  layout.addWidget(&lineEdit);
  layout.addWidget(button);

  // ウィジェットを表示
  QWidget window;
  window.setLayout(&layout);
  window.show();

  return 0;
}

QFileDialog::getExistingDirectory() は、既存のディレクトリのみを選択できるダイアログを表示します。QFileDialog::directoryUrl() よりもシンプルですが、機能も限定されています。

#include <QtWidgets/QFileDialog>

int main() {
  // ディレクトリ選択ダイアログを表示
  QString directoryPath = QFileDialog::getExistingDirectory();

  // 選択されたディレクトリを表示
  if (!directoryPath.isEmpty()) {
    qDebug() << "選択されたディレクトリ：" << directoryPath;
  }

  return 0;
}

まとめ

どの方法を使用するかは、アプリケーションの要件によって異なります。

• QFileDialog::directoryUrl() は、最も汎用性の高い方法です。
• QFileSystemModel は、ディレクトリツリーを表示したい場合に適しています。
• QLineEdit は、シンプルな方法でディレクトリパスを取得したい場合に適しています。
• QFileDialog::getExistingDirectory() は、既存のディレクトリのみを選択できる場合は