【Qt Widgets】QListViewでアイテム操作をマスター！追加・削除・編集・選択・ソート・フィルタリング

QListViewは、Qt WidgetsモジュールにおけるModel/Viewフレームワークの一部であるリストウィジェットクラスです。アイテムベースのリスト表示に特化しており、単一の列または複数の列に沿ってデータを効率的に表示します。

主な機能

さまざまな表示スタイル (アイコン付き、チェックボックス付きなど)
カスタマイズ可能なアイテム表示
ソートとフィルタリング
アイテムの選択とハイライト
アイテムの追加、削除、編集

モデルとの連携

QListViewは、データを保持するモデルと連携して動作します。モデルは、リストウィジェットに表示されるアイテムのデータソースとして機能します。QListViewは、モデルからのデータを抽出し、適切な形式で表示します。

主なモデル

QtListModel: アイテムとロールデータのみを扱うモデル
QAbstractItemModel: より複雑なデータ構造に対応するモデル
QStandardItemModel: シンプルなリストデータ用のデフォルトモデル

プログラミング例

#include <QtWidgets/QApplication>
#include <QtWidgets/QListView>
#include <QtWidgets/QStandardItemModel>

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

  // モデルの作成
  QStandardItemModel model;

  // アイテムの追加
  model.appendRow(QStandardItem("アイテム1"));
  model.appendRow(QStandardItem("アイテム2"));
  model.appendRow(QStandardItem("アイテム3"));

  // リストウィジェットの作成
  QListView listView;

  // モデルとリストウィジェットの関連付け
  listView.setModel(&model);

  // ウィジェットの表示
  listView.show();

  return app.exec();
}

カスタマイズ

QListViewは、さまざまなプロパティやメソッドを使用して外観と動作をカスタマイズできます。

スクロールバーの表示
ヘッダーの表示
編集モード
選択モード
アイテムの表示形式

QListViewの詳細については、Qt公式ドキュメントを参照してください。

データの表示方法や機能要件に応じて、適切なクラスを選択することが重要です。
QListView以外にも、Qt Widgetsモジュールにはさまざまなリストウィジェットクラスが用意されています。

アイテムの追加と削除

#include <QtWidgets/QApplication>
#include <QtWidgets/QListView>
#include <QtWidgets/QStandardItemModel>

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

  // モデルの作成
  QStandardItemModel model;

  // アイテムの追加
  model.appendRow(QStandardItem("アイテム1"));
  model.appendRow(QStandardItem("アイテム2"));
  model.appendRow(QStandardItem("アイテム3"));

  // リストウィジェットの作成
  QListView listView;

  // モデルとリストウィジェットの関連付け
  listView.setModel(&model);

  // アイテムの追加
  QStandardItem *newItem = new QStandardItem("新しいアイテム");
  model.appendRow(newItem);

  // アイテムの削除
  model.removeRow(1); // 2番目のアイテムを削除

  // ウィジェットの表示
  listView.show();

  return app.exec();
}

アイテムの選択とハイライト

#include <QtWidgets/QApplication>
#include <QtWidgets/QListView>
#include <QtWidgets/QStandardItemModel>

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

  // モデルの作成
  QStandardItemModel model;

  // アイテムの追加
  model.appendRow(QStandardItem("アイテム1"));
  model.appendRow(QStandardItem("アイテム2"));
  model.appendRow(QStandardItem("アイテム3"));

  // リストウィジェットの作成
  QListView listView;

  // モデルとリストウィジェットの関連付け
  listView.setModel(&model);

  // アイテムの選択
  listView.selectionModel()->select(model.indexFromItem(model.item(2)), QItemSelectionModel::Select);

  // ウィジェットの表示
  listView.show();

  return app.exec();
}

アイテムの編集

#include <QtWidgets/QApplication>
#include <QtWidgets/QListView>
#include <QtWidgets/QStandardItemModel>

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

  // モデルの作成
  QStandardItemModel model;

  // アイテムの追加
  model.appendRow(QStandardItem("アイテム1"));
  model.appendRow(QStandardItem("アイテム2"));
  model.appendRow(QStandardItem("アイテム3"));

  // リストウィジェットの作成
  QListView listView;

  // モデルとリストウィジェットの関連付け
  listView.setModel(&model);

  // 編集モードの設定
  listView.setEditTriggers(QAbstractItemView::DoubleClicked);

  // ウィジェットの表示
  listView.show();

  return app.exec();
}

ソートとフィルタリング

#include <QtWidgets/QApplication>
#include <QtWidgets/QListView>
#include <QtWidgets/QStandardItemModel>

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

  // モデルの作成
  QStandardItemModel model;

  // アイテムの追加
  model.appendRow(QStandardItem("りんご"));
  model.appendRow(QStandardItem("みかん"));
  model.appendRow(QStandardItem("ばなな"));
  model.appendRow(QStandardItem("ぶどう"));

  // リストウィジェットの作成
  QListView listView;

  // モデルとリストウィジェットの関連付け
  listView.setModel(&model);

  // ソート
  listView.sortByColumn(0); // 1番目の列でソート

  // フィルタリング
  listView.setFilter("ば.*"); // "ば" で始まるアイテムのみ表示

  // ウィジェットの表示
  listView.show();

  return app.exec();
}

#include <QtWidgets/QApplication>
#include <QtWidgets/QListView>
#include <QtWidgets/QStandardItemModel>
#include <QtWidgets/QDelegate>

class MyDelegate : public QItemDelegate {
public:
  void paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const override {
    if (index.column() == 1) {
      // 2番目の列のみカスタマイズ

代替候補と比較

ウィジェット	長所	短所
QListView	- シンプルで使いやすい<br>- 柔軟性とカスタマイズ性が高い<br>- モデル/ビューフレームワークとの連携に適している	- 複雑なレイアウトには不向き<br>- 高度なインタラクション機能には追加のプログラミングが必要
QTableView	- 表形式のデータ表示に最適<br>- セル編集機能など、表に特化した機能が豊富	- リスト形式のデータには不向き<br>- QListViewよりも複雑
QTreeWidget	- 階層構造のデータ表示に最適<br>- ドラッグ＆ドロップなどの機能が豊富	- リスト形式のデータには不向き<br>- QListViewよりも複雑
QGraphicsView	- 自由度の高いレイアウトとアニメーションが可能<br>- 複雑なインタラクションに対応できる	- 学習曲線がやや高い<br>- QListViewよりもパフォーマンスが低下する可能性がある
QCustomWidget	- 上記のいずれにも当てはまらない要件を満たすために、独自にウィジェットを作成できる	- 開発コストが高い<br>- デバッグが難しい

代替方法の選択

適切な代替方法は、データの種類、表示要件、機能要件によって異なります。

特殊な要件：QCustomWidgetが必要となります。
複雑なレイアウトやアニメーション：QGraphicsViewが最適です。
階層構造のデータ：QTreeWidgetが最適です。
表形式のデータ：QTableViewが最適です。
シンプルなリスト表示：QListViewが最適です。

データの表示方法や機能要件に応じて、適切なウィジェットを選択することが重要です。
上記以外にも、Qt Widgetsモジュールにはさまざまなウィジェットが用意されています。