【Qt】ファイル選択ができない？filesSelected() が呼ばれない原因と対策

2025-05-27

「void QFileDialog::filesSelected()」は、QtプログラミングにおけるQFileDialogクラスのシグナルの一つです。

シグナル（Signal）とは？

Qtのシグナルとスロットの仕組みにおける重要な要素です。シグナルは、ある特定のイベントが発生したことをオブジェクトが他のオブジェクトに通知するためのものです。例えるなら、「ボタンがクリックされた」とか「ファイルが選択された」といった出来事を知らせる合図のようなものです。

QFileDialogクラスとは？

QFileDialogは、ファイルを開いたり保存したりするための標準的なダイアログを提供するクラスです。ユーザーがファイルを選択したり、保存するファイル名を指定したりする際に利用されます。

filesSelected()シグナルについて

このfilesSelected()シグナルは、QFileDialogでユーザーが一つまたは複数のファイルを選択し、ダイアログを閉じた際に発行されます。

具体的には、ユーザーがファイル選択ダイアログでファイル（複数選択が許可されている場合は複数）を選び、「開く」ボタンや「選択」ボタンなどをクリックした後に、このシグナルが送信されます。

重要な点：

選択されたファイルへのパス（ファイル名を含むディレクトリ）は、接続されたスロット内でQFileDialogオブジェクトの別の関数（例えば、selectedFiles()など）を呼び出すことで取得できます。
このシグナルはvoid型の関数であり、引数を取りません。選択されたファイルの情報は、このシグナルに接続された**スロット（Slot）**と呼ばれる別の関数で処理されます。

例：

例えば、以下のようなコードでfilesSelected()シグナルにスロット関数を接続することができます。

#include <QApplication>
#include <QFileDialog>
#include <QDebug>

void processSelectedFiles() {
    QFileDialog dialog;
    if (dialog.exec()) {
        QStringList selectedFiles = dialog.selectedFiles();
        qDebug() << "選択されたファイル:";
        for (const QString &file : selectedFiles) {
            qDebug() << file;
        }
    }
}

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);

    QFileDialog fileDialog;
    QObject::connect(&fileDialog, &QFileDialog::filesSelected, []() {
        QFileDialog *dialog = qobject_cast<QFileDialog*>(QObject::sender());
        if (dialog) {
            QStringList selectedFiles = dialog->selectedFiles();
            qDebug() << "シグナル経由で選択されたファイル:";
            for (const QString &file : selectedFiles) {
                qDebug() << file;
            }
        }
    });

    fileDialog.exec(); // ダイアログを表示

    return a.exec();
}

この例では、filesSelectedシグナルが発行されると、ラムダ関数（無名関数）として定義されたスロットが実行され、選択されたファイルのパスが出力されます。

void QFileDialog::filesSelected()シグナル自体は、エラーを引き起こすというよりも、その接続や、接続されたスロット内での処理において問題が発生することが一般的です。

一般的なエラーとトラブルシューティング

- 原因
  - QFileDialogオブジェクトが適切にexec()メソッドで実行されていない。ダイアログが表示されなければ、ファイルの選択も完了せず、シグナルも発行されません。
  - QObject::connect()が正しく呼び出されていない。シグナルの種類 (&QFileDialog::filesSelected) や、接続先のスロットのシグネチャが間違っている可能性があります。
  - QFileDialogオブジェクトがスコープから外れて破棄されている。シグナルが発行される前にオブジェクトが消滅してしまうと、接続が無効になります。
  - ユーザーがファイルを全く選択せずにダイアログをキャンセルした場合、filesSelected()シグナルは発行されません。exec()の戻り値（QDialog::AcceptedまたはQDialog::Rejected) を確認し、ファイルが実際に選択されたかを確認する必要があります。
- トラブルシューティング
  - QFileDialogオブジェクトがexec()を呼び出していることを確認してください。
  - QObject::connect()の引数が正しいか、特にシグナルの指定 (&QFileDialog::filesSelected) を再確認してください。
  - QFileDialogオブジェクトが、シグナルが発行されるまで有効なスコープ内にあることを確認してください。
  - exec()の戻り値をチェックし、ユーザーがファイルを実際に選択したかを確認してください。
選択されたファイルパスが取得できない
- 原因
  - スロット内でselectedFiles()メソッドが呼び出されていない。
  - selectedFiles()メソッドの結果（QStringList）を適切に処理していない。例えば、空のリストである可能性を考慮していないなど。
  - スロット内でQFileDialogオブジェクトへのアクセスが間違っている。ラムダ式などでthisが意図したオブジェクトを指していない場合などがあります。
- トラブルシューティング
  - 接続されたスロット内で、QFileDialogオブジェクトのselectedFiles()メソッドを呼び出していることを確認してください。
  - selectedFiles()が返すQStringListが空でないかを確認し、適切にループ処理などを行ってください。
  - ラムダ式を使用している場合は、キャプチャリスト ([...]) が適切に設定されているか、またはsender()メソッドを使ってQFileDialogオブジェクトを取得しているかを確認してください。
意図しないファイルが選択される
- 原因
  - QFileDialogの初期設定（ディレクトリ、ファイルモード、フィルターなど）が意図した通りになっていない。
  - ユーザーが誤ってファイルを選択している。これはプログラミング上のエラーではありませんが、ユーザーインターフェースの設計を見直す必要があるかもしれません。
- トラブルシューティング
  - QFileDialogを作成する際に、setDirectory(), setFileMode(), setNameFilters()などのメソッドを使って、初期状態が適切に設定されているかを確認してください。
  - ユーザーが意図したファイルを選択しやすいように、ダイアログの表示や説明を工夫することを検討してください。
スロット内での処理が期待通りに行われない
- 原因
  - 接続されたスロット関数の実装に誤りがある。
  - 選択されたファイルパスを使った処理でエラーが発生している（ファイルが存在しない、権限がないなど）。
- トラブルシューティング
  - スロット関数のロジックを慎重に確認し、デバッガなどを利用して処理の流れを追跡してください。
  - ファイルパスを使ってファイル操作を行う場合は、ファイルが存在するか、適切な権限があるかなどを事前に確認する処理を追加してください。

デバッグのヒント

QObject::dumpObjectInfo()やQObject::dumpObjectTree()を使うと、オブジェクトのシグナルとスロットの接続状態を確認できます。
ブレークポイントを設定して、スロット関数の実行をステップ実行し、変数の値を確認してください。
qDebug()などのQtのデバッグ出力機能を使って、シグナルが発行されたか、スロットが実行されたか、選択されたファイルパスの内容などを確認してください。

例1：単一ファイル選択後にファイルパスを表示する

この例では、ユーザーが単一のファイルを選択し、「開く」ボタンをクリックすると、選択されたファイルのパスがコンソールに出力されます。

#include <QApplication>
#include <QFileDialog>
#include <QDebug>

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);

    QFileDialog fileDialog;
    fileDialog.setFileMode(QFileDialog::ExistingFile); // 単一ファイルのみ選択可能に設定

    // filesSelectedシグナルとラムダ式（スロット）を接続
    QObject::connect(&fileDialog, &QFileDialog::filesSelected,
                     [&](const QStringList &files) {
                         if (!files.isEmpty()) {
                             qDebug() << "選択されたファイル (filesSelected):" << files.first();
                         }
                     });

    // ダイアログの終了シグナルとラムダ式（スロット）を接続
    QObject::connect(&fileDialog, &QDialog::finished,
                     [&](int result) {
                         if (result == QDialog::Accepted) {
                             QStringList selectedFiles = fileDialog.selectedFiles();
                             if (!selectedFiles.isEmpty()) {
                                 qDebug() << "選択されたファイル (finished):" << selectedFiles.first();
                             }
                         } else {
                             qDebug() << "ファイル選択がキャンセルされました。";
                         }
                         QCoreApplication::quit(); // アプリケーションを終了
                     });

    fileDialog.exec(); // ダイアログを表示

    return a.exec();
}

解説

fileDialog.exec();: ファイル選択ダイアログを表示し、ユーザーの操作を待ちます。
QObject::connect(&fileDialog, &QDialog::finished, ...);: ダイアログが閉じられたときに発行されるfinishedシグナルにもラムダ式を接続しています。exec()の戻り値 (result) が QDialog::Accepted であれば、ユーザーが「開く」などをクリックしてダイアログを閉じたことを意味し、selectedFiles()メソッドで選択されたファイルパスを取得して出力します。
QObject::connect(&fileDialog, &QFileDialog::filesSelected, ...);: filesSelectedシグナルが発行されたときに実行するラムダ式（匿名関数）を接続します。このラムダ式は、選択されたファイルのリスト (QStringList &files) を引数として受け取ります。ここでは、リストが空でなければ最初のファイルパスを出力しています。
fileDialog.setFileMode(QFileDialog::ExistingFile);: ファイル選択モードを「既存の単一ファイル」のみ選択可能に設定します。
QFileDialog fileDialog;: QFileDialogオブジェクトを作成します。

例2：複数ファイル選択後にそれぞれのファイルパスを処理する

#include <QApplication>
#include <QFileDialog>
#include <QDebug>

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);

    QFileDialog fileDialog;
    fileDialog.setFileMode(QFileDialog::ExistingFiles); // 複数の既存ファイルを選択可能に設定

    // filesSelectedシグナルとラムダ式（スロット）を接続
    QObject::connect(&fileDialog, &QFileDialog::filesSelected,
                     [&](const QStringList &files) {
                         qDebug() << "選択されたファイル (filesSelected):";
                         for (const QString &file : files) {
                             qDebug() << "- " << file;
                         }
                     });

    // ダイアログの終了シグナルとラムダ式（スロット）を接続
    QObject::connect(&fileDialog, &QDialog::finished,
                     [&](int result) {
                         if (result == QDialog::Accepted) {
                             QStringList selectedFiles = fileDialog.selectedFiles();
                             qDebug() << "選択されたファイル (finished):";
                             for (const QString &file : selectedFiles) {
                                 qDebug() << "- " << file;
                             }
                         } else {
                             qDebug() << "ファイル選択がキャンセルされました。";
                         }
                         QCoreApplication::quit(); // アプリケーションを終了
                     });

    fileDialog.exec(); // ダイアログを表示

    return a.exec();
}

解説

filesSelectedシグナルに接続されたラムダ式では、引数として受け取った QStringList &files をループ処理し、各ファイルパスをコンソールに出力しています。
fileDialog.setFileMode(QFileDialog::ExistingFiles);: ファイル選択モードを「複数の既存ファイル」を選択可能に設定します。

例3：クラスのメンバ関数をスロットとして使用する

この例では、あるクラスのメンバ関数をfilesSelectedシグナルのスロットとして接続する方法を示します。

#include <QApplication>
#include <QFileDialog>
#include <QDebug>
#include <QWidget>
#include <QVBoxLayout>
#include <QPushButton>

class FileSelector : public QWidget {
public:
    FileSelector(QWidget *parent = nullptr) : QWidget(parent) {
        QVBoxLayout *layout = new QVBoxLayout(this);
        QPushButton *selectButton = new QPushButton("ファイルを選択", this);
        layout->addWidget(selectButton);

        fileDialog = new QFileDialog(this);
        fileDialog->setFileMode(QFileDialog::ExistingFiles);

        connect(selectButton, &QPushButton::clicked, this, &FileSelector::openFileDialog);
        connect(fileDialog, &QFileDialog::filesSelected, this, &FileSelector::processFiles);
    }

private slots:
    void openFileDialog() {
        fileDialog->exec();
    }

    void processFiles(const QStringList &files) {
        qDebug() << "選択されたファイル (スロット関数):";
        for (const QString &file : files) {
            qDebug() << "- " << file;
        }
    }

private:
    QFileDialog *fileDialog;
};

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);

    FileSelector selector;
    selector.show();

    return a.exec();
}

connect(fileDialog, &QFileDialog::filesSelected, this, &FileSelector::processFiles);: fileDialogのfilesSelectedシグナルを、FileSelectorクラスのprocessFilesスロットに接続しています。
processFiles(const QStringList &files)スロットは、fileDialogのfilesSelectedシグナルに接続され、選択されたファイルのリストを受け取って処理します。
openFileDialog()スロットは、ボタンがクリックされたときにfileDialog->exec()を呼び出してダイアログを表示します。
FileSelectorクラスは、ファイル選択ボタンと内部のQFileDialogオブジェクトを持ちます。

QFileDialog::getOpenFileName() および QFileDialog::getOpenFileNames() スタティック関数

これらのスタティック関数は、ダイアログを表示し、ユーザーがファイルを選択（または複数選択）して閉じると、選択されたファイルのパス（またはパスのリスト）を直接返します。シグナルとスロットの接続を明示的に行う必要がないため、簡単なファイル選択処理に適しています。

#include <QApplication>
#include <QFileDialog>
#include <QDebug>

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);

    // 単一ファイルを選択する場合
    QString openFileName = QFileDialog::getOpenFileName(
        nullptr,
        "ファイルを開く",
        "",
        "すべてのファイル (*.*);;テキストファイル (*.txt)"
    );

    if (!openFileName.isEmpty()) {
        qDebug() << "選択されたファイル (getOpenFileName):" << openFileName;
    }

    // 複数ファイルを選択する場合
    QStringList openFileNames = QFileDialog::getOpenFileNames(
        nullptr,
        "ファイルを開く",
        "",
        "すべてのファイル (*.*);;画像ファイル (*.png *.jpg)"
    );

    if (!openFileNames.isEmpty()) {
        qDebug() << "選択されたファイル (getOpenFileNames):";
        for (const QString &fileName : openFileNames) {
            qDebug() << "- " << fileName;
        }
    }

    return a.exec();
}

解説

引数として、親ウィジェット、ダイアログのタイトル、初期ディレクトリ、ファイルフィルターなどを指定できます。
これらの関数は、ダイアログが閉じられたときに選択されたファイルパスを直接返すため、シグナルを待つ必要がありません。
QFileDialog::getOpenFileNames(): ユーザーにファイルを開くダイアログを表示し、選択された複数のファイルのパスのリスト (QStringList) を返します。
QFileDialog::getOpenFileName(): ユーザーにファイルを開くダイアログを表示し、選択された単一のファイルのパスを返します。

QFileDialog::getSaveFileName() スタティック関数

このスタティック関数は、ファイルを保存するためのダイアログを表示し、ユーザーが指定した保存先のファイルパスを返します。

#include <QApplication>
#include <QFileDialog>
#include <QDebug>

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);

    QString saveFileName = QFileDialog::getSaveFileName(
        nullptr,
        "ファイルを保存",
        "",
        "テキストファイル (*.txt);;すべてのファイル (*.*)"
    );

    if (!saveFileName.isEmpty()) {
        qDebug() << "保存先ファイル (getSaveFileName):" << saveFileName;
    }

    return a.exec();
}

解説

QFileDialog::getSaveFileName(): ユーザーにファイルを保存するダイアログを表示し、指定された保存先のファイルパスを返します。

カスタムダイアログの作成

より複雑なファイル選択や操作が必要な場合は、QFileDialogを使用せずに、独自のウィジェットを組み合わせてカスタムダイアログを作成することも可能です。例えば、QListViewやQTableViewでファイルリストを表示し、ボタンや他のコントロールを追加して、独自のファイル選択ロジックを実装できます。

#include <QApplication>
#include <QWidget>
#include <QVBoxLayout>
#include <QListView>
#include <QPushButton>
#include <QFileSystemModel>
#include <QItemSelectionModel>
#include <QDebug>

class CustomFileDialog : public QWidget {
public:
    CustomFileDialog(QWidget *parent = nullptr) : QWidget(parent) {
        QVBoxLayout *layout = new QVBoxLayout(this);
        fileListView = new QListView(this);
        selectButton = new QPushButton("選択", this);
        layout->addWidget(fileListView);
        layout->addWidget(selectButton);

        fileSystemModel = new QFileSystemModel(this);
        fileSystemModel->setRootPath(QDir::homePath()); // ホームディレクトリを初期表示
        fileListView->setModel(fileSystemModel);
        selectionModel = fileListView->selectionModel();

        connect(selectButton, &QPushButton::clicked, this, &CustomFileDialog::getSelectedFiles);
    }

private slots:
    void getSelectedFiles() {
        QModelIndexList selectedIndexes = selectionModel->selectedIndexes();
        QStringList selectedFiles;
        for (const QModelIndex &index : selectedIndexes) {
            selectedFiles.append(fileSystemModel->filePath(index));
        }

        if (!selectedFiles.isEmpty()) {
            qDebug() << "選択されたファイル (カスタムダイアログ):";
            for (const QString &file : selectedFiles) {
                qDebug() << "- " << file;
            }
        } else {
            qDebug() << "ファイルが選択されていません。";
        }
    }

private:
    QListView *fileListView;
    QPushButton *selectButton;
    QFileSystemModel *fileSystemModel;
    QItemSelectionModel *selectionModel;
};

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);

    CustomFileDialog dialog;
    dialog.show();

    return a.exec();
}

解説

「選択」ボタンがクリックされると、getSelectedFiles()スロットが実行され、選択されたファイルのパスを取得して表示します。
QItemSelectionModelを使用して、ユーザーが選択したアイテムを取得します。
QFileSystemModelを使用してファイルシステムの内容をモデルとして提供し、QListViewで表示します。

高度なカスタマイズや独自のUIが必要な場合
独自のウィジェットを組み合わせてカスタムダイアログを作成する方法が柔軟性を提供します。
ダイアログのライフサイクルや結果をより細かく制御したい場合
QFileDialogオブジェクトを作成し、exec()で表示し、filesSelected()シグナルや finished() シグナルを利用する方法が適しています。
簡単なファイルを開く/保存処理
QFileDialog::getOpenFileName(), QFileDialog::getOpenFileNames(), QFileDialog::getSaveFileName() などのスタティック関数が簡潔で便利です。

Qtプログラミング初心者必見！QFileDialog::acceptModeのエラーと解決策

QFileDialog::acceptMode には主に以下の2つの値があります。QFileDialog::AcceptSave: これは、ユーザーがファイルを保存しようとしていることを示します。このモードでは、通常、ダイアログの「OK」ボタン（またはプラットフォームに応じた同等のボタン）のテキストが「保存」や「Save」といった表示になります。また、既に存在するファイル名を入力した場合に、上書きの確認ダイアログを表示するかどうか（confirmOverwrite プロパティによって制御されます）などの動作に影響を与えます。ファイルの保存ダイアログとして機能します。

Qt アプリケーション開発：QFileDialogのイベント処理をマスターする

保護された仮想関数 (protected virtual function): 保護された (protected): この関数は、QFileDialog クラス自身、およびその派生クラスからのみアクセスできます。外部のオブジェクトから直接呼び出すことはできません。仮想 (virtual): これは重要なポイントです。QFileDialog を継承して独自のファイルダイアログクラスを作成した場合、この関数を再実装（オーバーライド）することで、状態変化に対する独自の処理を記述できます。

Qt QFileDialog: currentChanged()の代替シグナルと使い分けを徹底解説

Qtプログラミングにおけるvoid QFileDialog::currentChanged(const QString &path)は、QFileDialog（ファイルダイアログ）クラスが提供するシグナルの一つです。このシグナルは、ユーザーがQFileDialog内で現在選択しているファイルまたはディレクトリが変更されたときに発生します。つまり、ユーザーがダイアログ内で別のファイルやフォルダをクリックしたり、キーボードで移動したりして、選択が変更されるたびにこのシグナルが発せられます。

void QFileDialog::currentUrlChanged()

Qt プログラミングにおける void QFileDialog::currentUrlChanged() は、QFileDialog クラスが提供するシグナルです。これは、ファイルダイアログ内でユーザーが選択しているファイルのURL（パス）が変更されたときに発生します。

【Qtプログラミング】QFileDialogのdefaultSuffix代替案！柔軟なファイル名制御を実現

QFileDialog::defaultSuffix は、Qtのファイルダイアログ（ファイルを開いたり保存したりする際に表示されるウィンドウ）において、ユーザーがファイル名に拡張子を入力しなかった場合に、自動的に追加されるデフォルトの拡張子を設定するためのプロパティです。

Qt フォルダ選択で困らない！QFileDialog::directory() のエラーと解決策

QFileDialog::directory() は、静的（スタティック）な関数で、ユーザーにディレクトリ（フォルダ）を選択させるための標準的なファイルダイアログを表示し、選択されたディレクトリのパスを表す QString オブジェクトを返します。もしユーザーがキャンセルした場合や、エラーが発生した場合は、空の QString が返されます。

Qtプログラミング入門: QFileDialog::directoryEntered()シグナルの徹底解説

Qtにおける void QFileDialog::directoryEntered(const QString &directory) は、QFileDialog クラスが提供するシグナルの一つです。どのようなときに発せられるか？このシグナルは、ユーザーがファイルダイアログ内でディレクトリ（フォルダ）を移動し、新しいディレクトリに入ったときに発せられます。例えば、ユーザーがファイルダイアログ上でダブルクリックしてサブフォルダを開いたり、パスを手動で入力して別のディレクトリに移動したりしたときに、このシグナルがトリガーされます。

Qt でディレクトリ選択ダイアログをカスタマイズする方法

QFileDialog::directoryUrl() は、Qt フレームワークの QFileDialog クラスのメソッドで、現在ダイアログに表示されているディレクトリの URL を取得します。具体的に何をするのか？ディレクトリ選択ダイアログの表示 QFileDialog を使って、ファイルやディレクトリを選択するためのダイアログを表示します。

QFileDialog::directoryUrlEnteredのよくあるエラーと解決策【Qt】

Qt プログラミングにおける void QFileDialog::directoryUrlEntered() は、QFileDialog クラスが提供するシグナルです。どのようなときに発生するか？このシグナルは、ユーザーが QFileDialog （ファイル選択ダイアログ）内で、新しいディレクトリの URL（Uniform Resource Locator）を入力または選択し、そのディレクトリに入ろうとしたときに発行されます。

QFileDialog::done()の深掘り：内部動作とカスタマイズのヒント

まず、QFileDialog はQtにおける標準的なファイルダイアログを提供するクラスです。これは、ユーザーがファイルを開いたり、保存したり、ディレクトリを選択したりする際に使用されるGUIコンポーネントです。done() メソッドは、QDialog クラス（QFileDialog が継承しているクラス）から継承された保護された（protected）スロットです。このメソッドは、ダイアログが閉じられる際に呼び出され、ダイアログの結果コード（Accepted または Rejected）を設定するために使用されます。