Qt5の自作ウィジェットにStyleSheetのための独自属性を設けたい。背景色はこの自作ウィジェットを利用する人に決めさせてあげたい

Question

Qt5で３つの状態により背景色を変えて見せるQLabel派生の自作ウィジェットを作成しました。

ざっと次のようになります。

#include <QLabel>

class StatusIndicator : public QLabel
{
Q_OBJECT
public:
    enum class Status {
        Unknown,　// 不明
        Normal,  // 正常
        Error  // 異常
    };

public:
    explicit StatusIndicator(const Status &initStatus = Status::Unknown, QWidget *parent = Q_NULLPTR, Qt::WindowFlags f = Qt::WindowFlags());

    Status status();
    void setStatus(const Status &status);  // 状態が変わったら背景色も変えたい。色はクライアントに任意にしたい

private:
    Status _status{Status::Unknown};

private:

    QString generateText(const Status &status);
};

現時点、３つの状態に対応するbackgroud-colorはハードコーディングで決め打ちです。これだといまいちなので改良しようと考えています。

改良として、このクラスを利用する側（クライアントと呼びます）に任意として、状態に対応する背景色をそれぞれ設定できるようにしたいのですが、その方法がわかりません。

(1) 自作ウィジェットにQt5スタイルシートで認識できる独自属性を設けることはできるのでしょうか？できるとして、どうすれば良いのでしょうか？

(2) 独自属性の値（先述のクラスであればNormal/Error）に基づきbackground-colorを変更する方法はないものでしょうか。

イメージとしては、次のように背景色の変更ができるようにしたいです。

auto label = StatusIndicator(StatusIndicator::Status::Normal, this);
// StatusIndicatorのstatus属性がNormalの時は背景をLime色にしたい
label->setStyleSheet("StatusIndicator::_status:Normal {background-color: Lime;"});
// StatusIndicatorのstatus属性がErrorの時は背景をOrangeRed色にしたい
label->setStyleSheet("StatusIndicator::_status:Error {background-color: OrangeRed;"});
/*
 * （補足）このコードでは色を変更することができません
 */

念の為コードを掲載しておきます。

#include <QtGlobal>

#include "GStatusIndicator.h"


GStatusIndicator::GStatusIndicator(const Status &initStatus, QWidget *parent, Qt::WindowFlags f)
    :QLabel(generateText(initStatus), parent, f)
{
    setFrameShape(QFrame::Panel);
    setFrameShadow(QFrame::Sunken);
}

GStatusIndicator::Status GStatusIndicator::status()
{
    return _status;
}

/*
 * 背景色が固定で変更できないのはいまいち
 */
void GStatusIndicator::setStatus(const Status &status)
{
    if (status != _status)
    {
        _status = status;
        setText(generateText(_status));     // 正常 or 異常 or 不明

        switch (_status)
        {
            case Status::Normal:
            {
                setStyleSheet("background-color: lime;");
                break;
            }

            case Status::Error:
            {
                setStyleSheet("background-color: OrangeRed;");
                break;
            }

            default:
            {
                setStyleSheet("background-color: lightgrey;");
                break;
            }
        }
    }
}

QString GStatusIndicator::generateText(const Status &status)
{
    switch (status)
    {
        case Status::Unknown:
            return {"不明"};

        case Status::Normal:
            return {"正常"};

        case Status::Error:
            return {"異常"};

        default:
            Q_ASSERT_X(false, __func__, QString("Invalid status=%1").arg(static_cast<int>(status)).toStdString().c_str());
            break;
    }
}

Answer 1

statusをプロパティとして定義すればセレクタで指定できました。
enumのままだと数値でしか指定できないみたいなので、文字列としてプロパティにしています。

class StatusIndicator : public QLabel
{
    Q_OBJECT
    // こっちだと数値で指定
    //Q_PROPERTY(Status status READ status WRITE setStatus)
    Q_PROPERTY(QString status MEMBER _statusText)

public:
    enum class Status {
        Unknown, // 不明
        Normal, // 正常
        Error // 異常
    };
    Q_ENUM(Status);

public:
    explicit StatusIndicator(QWidget* parent= nullptr) : QLabel(parent) {}

    Status status() const { return _status; }
    void setStatus(const Status &status) {
        _status = status;
        if (_status == Status::Unknown) { _statusText = "Unknown"; }
        else if (_status == Status::Normal) { _statusText = "Normal"; }
        else if (_status == Status::Error) { _statusText = "Error"; }
        setText(_statusText);
    }

private:
    Status _status{Status::Unknown};
    QString _statusText;
};

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    auto indicator1 = new StatusIndicator(ui->centralwidget);
    auto indicator2 = new StatusIndicator(ui->centralwidget);
    auto indicator3 = new StatusIndicator(ui->centralwidget);

// 数値の場合
//    auto ss = R"(
//StatusIndicator[status="0"] { background-color: Pink; }
//StatusIndicator[status="1"] { background-color: Lime; }
//StatusIndicator[status="2"] { background-color: OrangeRed; }
//)";

    auto ss = R"(
StatusIndicator[status="Unknown"] { background-color: Pink; }
StatusIndicator[status="Normal"] { background-color: Lime; }
StatusIndicator[status="Error"] { background-color: OrangeRed; }
)";

    indicator1->setStyleSheet(ss);
    indicator2->setStyleSheet(ss);
    indicator3->setStyleSheet(ss);

    auto button = new QPushButton("Change");
    connect(button, &QPushButton::clicked, this, [=] {
        indicator1->setStatus(StatusIndicator::Status::Error);
        indicator2->setStatus(StatusIndicator::Status::Unknown);
        indicator3->setStatus(StatusIndicator::Status::Normal);
    });

    auto layout = new QVBoxLayout(ui->centralwidget);
    layout->addWidget(indicator1);
    layout->addWidget(indicator2);
    layout->addWidget(indicator3);
    layout->addWidget(button);
    layout->addStretch(1);

    indicator1->setStatus(StatusIndicator::Status::Unknown);
    indicator2->setStatus(StatusIndicator::Status::Normal);
    indicator3->setStatus(StatusIndicator::Status::Error);
}

Comments

[jiro.kaihatsu]

アドバイスありがとうございました。
お陰様でQColor型のプロパティを持つことを止めて、文字列型（または整数）で持つとイメージ通りのStatusIndicatorにすることができました。
（追伸）
私の手元では１行追加しました。
void StatusIndicator::setStatus(const Status &status)
{
_status = status;
if (_status == Status::Unknown) { _statusText = "Unknown"; }
else if (_status == Status::Normal) { _statusText = "Normal"; }
else if (_status == Status::Error) { _statusText = "Error"; }
setText(_statusText);
style()->polish(this);　　// 追加
}