Qtでリストアイテムをカラフルに彩る: QListWidgetItem::setForeground()の使い方

Qt WidgetsにおけるQListWidgetItem::setForeground()解説

QListWidgetItem::setForeground() は、Qt Widgets モジュールで提供される関数で、QListWidget アイテムの前景 (テキストの色) を設定するために使用されます。

コード例

// アイテムの作成
QListWidgetItem *item = new QListWidgetItem("アイテム");

// 前景色の設定
item->setForeground(QColor::red);

// リストウィジェットへの追加
QListWidget *listWidget = new QListWidget;
listWidget->addItem(item);

引数

• color: 設定したい前景色の QColor オブジェクト

戻り値

なし

詳細

• QColor オブジェクトは、RGB 値や名前など、さまざまな方法で指定できます。
• setForeground() 関数は、アイテムのすべてのテキストに適用されます。
• アイテムの背景色を設定するには、setBackground() 関数を使用します。
• アイテムのフォントを設定するには、setFont() 関数を使用します。

例

以下の例では、QListWidget アイテムの前景色を赤色に設定しています。

#include <QtWidgets>

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

  // アイテムの作成
  QListWidgetItem *item = new QListWidgetItem("アイテム");

  // 前景色の設定
  item->setForeground(QColor::red);

  // リストウィジェットへの追加
  QListWidget *listWidget = new QListWidget;
  listWidget->addItem(item);

  listWidget->show();

  return app.exec();
}

QListWidgetItem::setForeground() のサンプルコード

アイテムの色をランダムに設定する

#include <QtWidgets>
#include <QtRandom>

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

  // リストウィジェットの作成
  QListWidget listWidget;

  // ランダムジェネレータの生成
  QRandom random;

  // 10個のアイテムを追加
  for (int i = 0; i < 10; ++i) {
    // アイテムの作成
    QListWidgetItem *item = new QListWidgetItem("アイテム" + QString::number(i + 1));

    // ランダムな色の生成
    QColor color(random.nextInt(256), random.nextInt(256), random.nextInt(256));

    // 前景色の設定
    item->setForeground(color);

    // リストウィジェットへの追加
    listWidget.addItem(item);
  }

  listWidget.show();

  return app.exec();
}

アイテムの状態によって色を変える

#include <QtWidgets>

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

  // リストウィジェットの作成
  QListWidget listWidget;

  // アイテムの作成
  QListWidgetItem *item1 = new QListWidgetItem("アイテム1");
  QListWidgetItem *item2 = new QListWidgetItem("アイテム2");
  QListWidgetItem *item3 = new QListWidgetItem("アイテム3");

  // アイテムの状態の設定
  item1->setSelected(true);
  item2->setCheckState(Qt::Checked);

  // アイテムの色設定
  item1->setForeground(QColor::red);
  item2->setForeground(QColor::blue);
  item3->setForeground(QColor::green);

  // リストウィジェットへの追加
  listWidget.addItem(item1);
  listWidget.addItem(item2);
  listWidget.addItem(item3);

  listWidget.show();

  return app.exec();
}

アイテムのテキストと背景色を同時に設定する

#include <QtWidgets>

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

  // リストウィジェットの作成
  QListWidget listWidget;

  // アイテムの作成
  QListWidgetItem *item = new QListWidgetItem("アイテム");

  // テキストと背景色の設定
  item->setText("重要");
  item->setForeground(QColor::red);
  item->setBackgroundColor(QColor::yellow);

  // リストウィジェットへの追加
  listWidget.addItem(item);

  listWidget.show();

  return app.exec();
}

QListWidgetItem::setForeground() 以外の方法

QItemDelegate は、リストウィジェットなどのアイテムビューの表示と編集をカスタマイズするために使用されます。

コード例

#include <QtWidgets>

class MyDelegate : public QItemDelegate {
public:
  MyDelegate(QObject *parent = nullptr) : QItemDelegate(parent) {}

  void paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const override {
    // アイテムのテキストを描画
    QItemDelegate::paint(painter, option, index);

    // 前景色の設定
    if (index.row() % 2 == 0) {
      painter->setPen(QColor::red);
    } else {
      painter->setPen(QColor::blue);
    }

    // テキストを描画
    painter->drawText(option.rect, Qt::AlignCenter, index.data().toString());
  }
};

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

  // リストウィジェットの作成
  QListWidget listWidget;

  // デリゲートの設定
  listWidget.setItemDelegate(new MyDelegate());

  // アイテムの追加
  for (int i = 0; i < 10; ++i) {
    listWidget.addItem(new QListWidgetItem("アイテム" + QString::number(i + 1)));
  }

  listWidget.show();

  return app.exec();
}

QStyleSheet を使用

QStyleSheet は、Qt アプリケーションのウィジェットのスタイルをカスタマイズするために使用されます。

コード例

#include <QtWidgets>

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

  // リストウィジェットの作成
  QListWidget listWidget;

  // スタイルシートの設定
  listWidget.setStyleSheet("QListWidget::item { color: red; }");

  // アイテムの追加
  for (int i = 0; i < 10; ++i) {
    listWidget.addItem(new QListWidgetItem("アイテム" + QString::number(i + 1)));
  }

  listWidget.show();

  return app.exec();
}

これらの方法は、QListWidgetItem::setForeground() 関数よりも柔軟性がありますが、より複雑です。