Qt：画像ファイル、テキストファイル、ソースファイルなど、ファイルの種類ごとにダイアログボックスをカスタマイズする

Qt WidgetsにおけるQFileDialog::nameFilters()の分かりやすい解説

基本的な使い方

// フィルターリストを作成
QStringList filters;
filters << "*.txt" << "*.cpp" << "*.h";

// ファイルダイアログボックスを作成
QFileDialog dialog(this);
dialog.setNameFilters(filters);

// ダイアログボックスを表示
dialog.exec();

// 選択されたファイル名を取得
QString selectedFile = dialog.selectedFiles().first();

上記のコード例では、テキストファイル、C++ソースファイル、ヘッダーファイルのみを選択できるようにフィルターリストを作成し、それをQFileDialog::setNameFilters()関数に渡しています。

詳細な設定

ワイルドカードの使用

ファイル名フィルターには、ワイルドカードを使用して複数のファイル名パターンを指定することができます。例えば、 "*.txt" というフィルターは、拡張子が "txt" のすべてのファイルにマッチします。

説明文の追加

各フィルターには、ユーザーに表示される説明文を追加することができます。説明文は、QFileDialog::setNameFilters()関数の第二引数として渡す文字列リストにカンマ区切りで指定します。

// フィルターリストを作成
QStringList filters;
filters << "*.txt" << "テキストファイル (*.txt)" << "*.cpp" << "C++ソースファイル (*.cpp)" << "*.h" << "ヘッダーファイル (*.h)";

// ファイルダイアログボックスを作成
QFileDialog dialog(this);
dialog.setNameFilters(filters);

// ダイアログボックスを表示
dialog.exec();

上記のコード例では、各ファイル名フィルターの説明文を追加しています。

デフォルトフィルターの設定

QFileDialog::setDefaultFilter()関数を使用して、デフォルトで選択されるファイル名フィルターを設定することができます。

// フィルターリストを作成
QStringList filters;
filters << "*.txt" << "*.cpp" << "*.h";

// デフォルトフィルターを設定
dialog.setDefaultFilter("*.txt");

// ファイルダイアログボックスを表示
dialog.exec();

上記のコード例では、デフォルトフィルターとして "*.txt" を設定しています。

その他

• QFileDialog::nameFilters()関数は、複数のフィルターを同時に設定することができます。
• ユーザーは、ダイアログボックスのドロップダウンリストからフィルターを選択することができます。
• QFileDialog::setNameFilters()関数は、ファイルダイアログボックスが表示される前に呼び出す必要があります。

補足

• 上記の解説は、Qt Widgets 5.15に基づいています。
• Qt Widgetsのバージョンによって、QFileDialog::nameFilters()関数の機能が異なる場合があります。

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

画像ファイルのみを選択する

QStringList filters;
filters << "*.png" << "*.jpg" << "*.jpeg" << "*.bmp";

QFileDialog dialog(this);
dialog.setNameFilters(filters);
dialog.exec();

QString selectedFile = dialog.selectedFiles().first();

テキストファイルとソースファイルを選択する

QStringList filters;
filters << "*.txt" << "*.cpp" << "*.h";

QFileDialog dialog(this);
dialog.setNameFilters(filters);
dialog.exec();

QString selectedFile = dialog.selectedFiles().first();

説明文付きのフィルター

QStringList filters;
filters << "*.txt" << "テキストファイル (*.txt)" << "*.cpp" << "C++ソースファイル (*.cpp)" << "*.h" << "ヘッダーファイル (*.h)";

QFileDialog dialog(this);
dialog.setNameFilters(filters);
dialog.exec();

QString selectedFile = dialog.selectedFiles().first();

デフォルトフィルター

QStringList filters;
filters << "*.txt" << "*.cpp" << "*.h";

QFileDialog dialog(this);
dialog.setDefaultFilter("*.txt");
dialog.setNameFilters(filters);
dialog.exec();

QString selectedFile = dialog.selectedFiles().first();

複数のフィルターを同時に設定

QStringList filters;
filters << "*.txt" << "*.cpp" << "*.h";
filters << "*.png" << "*.jpg" << "*.jpeg" << "*.bmp";

QFileDialog dialog(this);
dialog.setNameFilters(filters);
dialog.exec();

QString selectedFile = dialog.selectedFiles().first();

ファイル名フィルターの取得

QStringList filters = dialog.nameFilters();

// ...

ダイアログボックスのタイトル設定

QFileDialog dialog(this);
dialog.setWindowTitle("ファイルを選択");
dialog.setNameFilters(filters);
dialog.exec();

ダイアログボックスのアイコン設定

QFileDialog dialog(this);
dialog.setWindowIcon(QIcon(":/icon.png"));
dialog.setNameFilters(filters);
dialog.exec();

保存ダイアログボックス

QFileDialog dialog(this, Qt::SaveFile);
dialog.setNameFilters(filters);
dialog.exec();

QString selectedFile = dialog.selectedFiles().first();

開くディレクトリ設定

QFileDialog dialog(this);
dialog.setDirectory("/home/user/Documents");
dialog.setNameFilters(filters);
dialog.exec();

QString selectedFile = dialog.selectedFiles().first();

ファイル存在チェック

QFileDialog dialog(this);
dialog.setNameFilters(filters);
dialog.exec();

QString selectedFile = dialog.selectedFiles().first();

if (!QFile::exists(selectedFile)) {
  // ファイルが存在しない
} else {
  // ファイルが存在する
}

ファイル読み込み

QFileDialog dialog(this);
dialog.setNameFilters(filters);
dialog.exec();

QString selectedFile = dialog.selectedFiles().first();

QFile file(selectedFile);
if (file.open(QIODevice::ReadOnly)) {
  // ファイルの内容を読み込む
} else {
  // ファイルを開けなかった
}

ファイル書き込み

QFileDialog dialog(this);
dialog.setNameFilters(filters);
dialog.exec();

QString selectedFile = dialog.selectedFiles().first();

QFile file(selectedFile);
if (file.open(QIODevice::WriteOnly)) {
  // ファイルに書き込む
} else {
  // ファイルを開けなかった
}

QFileDialog::nameFilters() 以外の方法

QFileSystemModel クラスを使用すると、ファイルシステムをモデルとして表現することができます。モデルを使用して、ダイアログボックスに表示されるファイルとフォルダをフィルタリングすることができます。

QFileSystemModel model;
model.setFilter(QDir::NoDotAndDotDot | QDir::Files);

QFileDialog dialog(this);
dialog.setModel(&model);
dialog.exec();

QListView クラスを使用すると、ファイルとフォルダのリストを表示することができます。リストに表示される項目をフィルタリングするために、QSortFilterProxyModel クラスを使用することができます。

QListView listView;

QSortFilterProxyModel proxyModel;
proxyModel.setSourceModel(&model);
proxyModel.setFilterKeyColumn(0);
proxyModel.setFilterRegExp(".*\\.txt");

listView.setModel(&proxyModel);

QFileDialog dialog(this);
dialog.setView(&listView);
dialog.exec();

独自のファイルダイアログボックスを作成することもできます。Qt Designer を使用して、ダイアログボックスのレイアウトをデザインすることができます。

class MyFileDialog : public QDialog {
  Q_OBJECT

public:
  MyFileDialog(QWidget *parent = nullptr);

private:
  void accept() override;

  // ...
};

MyFileDialog::MyFileDialog(QWidget *parent) : QDialog(parent) {
  // ...
}

void MyFileDialog::accept() {
  // ...
}

// ...

QFileDialog::nameFilters() は、ファイルダイアログボックスでユーザーが選択できるファイルの種類を制限するための簡単な方法です。ただし、より複雑なフィルタリング機能が必要な場合は、他の方法を使用する必要があります。