【C++】QtのQSpinBoxで実現する直感的な整数入力ウィジェットの基本操作とカスタマイズ例

#include <QApplication>
#include <QSpinBox>
#include <QWidget>
#include <QVBoxLayout>

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

    QSpinBox *spinBox = new QSpinBox(&window);
    spinBox->setRange(0, 100);
    spinBox->setMinimumWidth(100);  // 幅を広げる

    QVBoxLayout *layout = new QVBoxLayout(&window);
    layout->addWidget(spinBox);

    window.setLayout(layout);
    window.show();

    return app.exec();
}

// アプリケーション起動後、0～100の範囲内で値を操作できるウィジェットが表示されます

#include <QApplication>
#include <QSpinBox>
#include <QWidget>
#include <QVBoxLayout>

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

    QSpinBox spinBox(&window);
    spinBox.setRange(0, 100);
    spinBox.setMinimumWidth(100);
    spinBox.setValue(50);         // 初期値を50に設定

    QVBoxLayout *layout = new QVBoxLayout(&window);
    layout->addWidget(&spinBox);

    window.setLayout(layout);
    window.show();

    return app.exec();
}

// ウィジェット表示時、初期値50が入力された状態で表示されます

#include <QApplication>
#include <QSpinBox>
#include <QWidget>
int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    QWidget window;
    QSpinBox spinBox(&window);
    spinBox.setMinimumWidth(100);
    spinBox.setRange(0, 100);        // 範囲設定
    spinBox.setSingleStep(5);        // ステップ幅を5に設定
    spinBox.setValue(20);            // 初期値を20に設定
    window.show();
    return app.exec();
}

// 矢印ボタンを操作すると、数値が5ずつ増減する動作が確認できます

#include <QApplication>
#include <QSpinBox>
#include <QWidget>
int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    QWidget window;
    QSpinBox spinBox(&window);
    spinBox.setMinimumWidth(100);
    spinBox.setRange(0, 100);
    spinBox.setValue(30);
    spinBox.setPrefix("$");  // 数値の前に"$"を表示
    window.show();
    return app.exec();
}

// 表示される数値の左側に"$"が追加されて、「$30」等の形式で表示されます

#include <QApplication>
#include <QSpinBox>
#include <QWidget>
int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    QWidget window;
    QSpinBox spinBox(&window);
    spinBox.setMinimumWidth(100);
    spinBox.setRange(-50, 50);
    spinBox.setValue(0);
    spinBox.setSuffix(" °C");  // 数値の後に" °C"を表示
    window.show();
    return app.exec();
}

// 数値の右側に" °C"が表示され、「0 °C」などの形で表現されます

#include <QApplication>
#include <QSpinBox>
#include <QWidget>
#include <QDebug>
// CustomSpinBoxクラスはQSpinBoxを継承して、追加の動作を実装する
class CustomSpinBox : public QSpinBox {
public:
    CustomSpinBox(QWidget *parent = nullptr) : QSpinBox(parent) {
        // 初期値や範囲を設定する
        setRange(0, 255);
        setValue(128);
        setMinimumWidth(100);
    }
protected:
    // 入力されたテキストから値を取得するための関数をオーバーライド
    int valueFromText(const QString &text) const override {
        // シンプルな実装例として、通常の整数変換を行う
        return text.toInt();
    }
    // 値を文字列に変換するための関数もオーバーライド
    QString textFromValue(int value) const override {
        // 16進数で表示する例として「0x」プレフィックスを付加する
        return QString("0x%1").arg(value, 0, 16);
    }
};
int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    QWidget window;
    CustomSpinBox customSpinBox(&window);
    customSpinBox.move(20, 20);
    window.show();
    // カスタムスピンボックスの初期化と動作を確認するためのデバッグ出力
    qDebug() << "CustomSpinBox初期値:" << customSpinBox.value();
    return app.exec();
}

// 起動すると、ウィンドウ内に表示されるカスタムスピンボックスには数値が16進数表示で表現される
// 例えば、初期値128は「0x80」と表示される

#include <QApplication>
#include <QSpinBox>
#include <QWidget>
#include <QDebug>
class HexSpinBox : public QSpinBox {
public:
    HexSpinBox(QWidget *parent = nullptr) : QSpinBox(parent) {
        // 0〜255の範囲を設定する
        setRange(0, 255);
        setValue(15);
        setMinimumWidth(100);
    }
protected:
    int valueFromText(const QString &text) const override {
        // 入力されたテキストを16進数として解釈する
        bool ok = false;
        int value = text.toInt(&ok, 16);
        return ok ? value : 0;
    }
    QString textFromValue(int value) const override {
        // 数値を16進数文字列に変換する(小文字で表示)
        return QString("0x%1").arg(value, 0, 16);
    }
};
int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    QWidget window;
    HexSpinBox spinBox(&window);
    spinBox.move(20, 20);
    window.show();
    qDebug() << "HexSpinBox初期値:" << spinBox.value();
    return app.exec();
}

// HexSpinBoxが表示され、初期値15は「0xf」として表示される

#include <QApplication>
#include <QSpinBox>
#include <QWidget>
#include <QDebug>
#include <QValidator>
class ValidatedSpinBox : public QSpinBox {
public:
    ValidatedSpinBox(QWidget *parent = nullptr) : QSpinBox(parent) {
        setRange(10, 90);
        setValue(50);
        setMinimumWidth(100);
    }
protected:
    QValidator::State validate(QString &input, int &pos) const override {
        // 入力された文字列が数字のみで構成されているかを判定する
        if (input.isEmpty())
            return QValidator::Intermediate;
        bool ok = false;
        int value = input.toInt(&ok);
        // 範囲チェックも行う
        if (!ok || value < 10 || value > 90)
            return QValidator::Invalid;
        return QValidator::Acceptable;
    }
};
int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    QWidget window;
    ValidatedSpinBox spinBox(&window);
    spinBox.move(20, 20);
    window.show();
    qDebug() << "ValidatedSpinBox初期値:" << spinBox.value();
    return app.exec();
}

// ValidatedSpinBoxは、10〜90の範囲内でのみ有効な入力とし、範囲外の入力はエラー扱いとなります