Qt QSpinBoxの「最大値」を使いこなす：コード例とトラブルシューティング

2025-05-31

QSpinBox::maximum とは

QSpinBox::maximum は、Qtフレームワークの QSpinBox クラスにおけるプロパティ（属性）の一つです。QSpinBox は、ユーザーが数値（整数）を増減させるためのウィジェットで、通常、テキストボックスと上下の矢印ボタンで構成されます。

この maximum プロパティは、QSpinBoxが取りうる数値の最大値を定義します。

役割

QSpinBox::maximum の主な役割は以下の通りです。

入力範囲の制限: ユーザーがSpinBoxに入力できる数値の上限を設定します。例えば、年齢を入力するSpinBoxであれば、最大値を120などに設定することで、現実的ではない大きな数値の入力を防ぐことができます。
UIの制御: ユーザーが上下の矢印ボタンをクリックした際、値がこの最大値を超えないように自動的に制限されます。最大値に達すると、それ以上「上」に増やすことはできなくなります（ただし、wrapping プロパティが有効な場合は、最大値を超えると最小値に戻る循環動作をします）。
バリデーション: SpinBoxに入力された値がこの最大値を超えている場合、QSpinBoxはそれを無効な入力として扱い、通常は最大値に丸めたり、入力できないようにしたりします。

設定方法

QSpinBox::maximum の値は、以下の方法で設定できます。

setMaximum() メソッドで設定: 既存の QSpinBox オブジェクトに対して、最大値を後から設定できます。
```
QSpinBox* spinBox = new QSpinBox();
spinBox->setMaximum(200); // 最大値を200に設定
```
コンストラクタで設定: QSpinBox を作成する際に、最小値と最大値を同時に指定するコンストラクタを使用できます。
```
QSpinBox* spinBox = new QSpinBox(parent);
spinBox->setRange(0, 100); // 最小値を0、最大値を100に設定
```

関連するプロパティ・メソッド

wrapping: このプロパティが true に設定されている場合、値が maximum に達した後に「上」ボタンを押すと minimum に戻り、minimum に達した後に「下」ボタンを押すと maximum に戻る循環動作をします。
setRange(int minimum, int maximum): 最小値と最大値を同時に設定する便利なメソッドです。setMinimum() と setMaximum() を個別に呼び出すのと同等です。
singleStep(): 上下ボタンを押したときに値がどれだけ増減するかを定義します。
setValue(): SpinBoxの数値を設定します。
value(): 現在のSpinBoxの数値を取得します。
minimum: SpinBoxが取りうる数値の最小値を定義します。

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

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

    QWidget window;
    QVBoxLayout *layout = new QVBoxLayout(&window);

    QSpinBox *spinBox = new QSpinBox(&window);

    // 最大値を設定
    spinBox->setMaximum(50); // SpinBoxの最大値を50に設定します
    spinBox->setMinimum(0);  // 最小値は0とします

    // 初期値を設定
    spinBox->setValue(25);

    layout->addWidget(spinBox);
    window.setLayout(layout);
    window.setWindowTitle("QSpinBox Maximum Example");
    window.show();

    return app.exec();
}

この例では、QSpinBox の最大値が50に設定されているため、ユーザーは50より大きな値を入力したり、矢印ボタンで50を超えて値を増やしたりすることはできません。

QSpinBox::maximum は、QSpinBox が受け入れることができる数値の最大値を設定する重要なプロパティですが、関連する設定や期待される動作との間でよく誤解が生じることがあります。

エラー: setValue() で設定した値が maximum を超えてしまう

現象: spinBox->setMaximum(100); と設定したにもかかわらず、spinBox->setValue(200); のように最大値を超える値を設定できてしまうように見える。

原因: setValue() メソッドは、設定された値が minimum と maximum の範囲外である場合、自動的にその範囲内に「クランプ（丸め）」します。つまり、setValue(200) を呼び出すと、内部的には値が maximum の100に設定されます。見た目上はエラーが出ませんが、期待した値が設定されていないという点で「エラー」と捉えられることがあります。

トラブルシューティング:

事前のバリデーション: setValue() を呼び出す前に、設定しようとしている値が minimum と maximum の範囲内にあるかを自分でチェックし、範囲外であればユーザーに通知するなどの処理を挟むことも検討してください。
値の確認: setValue() の後に spinBox->value() を呼び出して、実際に設定された値を確認してください。おそらく、maximum に丸められているはずです。

エラー: maximum を設定したのに、入力が制限されない（特に手動入力時）

現象: setMaximum() で最大値を設定したにもかかわらず、ユーザーがSpinBoxのテキストフィールドに最大値を超える数値を手動で入力できてしまう。

原因: QSpinBox はデフォルトで入力のバリデーションを行いますが、ユーザーが入力中の段階では、まだ完全な数値として解釈されていないため、一時的に範囲外の数値を入力できることがあります。最終的にテキストフィールドからフォーカスが外れたり、Enterキーが押されたりしたときにバリデーションが行われ、値が最大値に丸められます。

トラブルシューティング:

カスタムバリデーション: より厳密なリアルタイムバリデーションが必要な場合は、QSpinBox を継承し、validate() メソッドをオーバーライドすることで、入力中の文字ごとのバリデーションロジックをカスタマイズできます。しかし、これは複雑になるため、通常は不要です。
editingFinished() シグナルの利用: ユーザーが入力確定した後に特定の処理を行いたい場合は、editingFinished() シグナルを捕捉し、その時点で value() を取得して処理を行うことができます。このとき、値はすでに範囲内にクランプされています。
動作の理解: これはQtの標準的な動作であり、エラーではありません。ユーザーが入力確定（Enterキー押下やフォーカス移動）するまで、一時的な無効な入力は許容されます。

エラー: minimum と maximum の関係性に関する問題

現象: setMinimum() と setMaximum() を設定する順序や値の関係性によって、期待しない動作になる。例: setMinimum(100); setMaximum(50); のように最小値が最大値より大きくなる設定をしてしまう。

原因: QSpinBox は、常に minimum <= maximum の関係が成り立つように内部で調整します。もし setMinimum() で設定した値が現在の maximum より大きくなった場合、maximum もその新しい minimum と同じ値に自動的に調整されます。逆も同様です。

トラブルシューティング:

設定順序の考慮: 個別に設定する場合は、まず最小値を設定し、次に最大値を設定するのが一般的です。
```
spinBox->setMinimum(0);
spinBox->setMaximum(100); // この順序で設定する
```
もし spinBox->setMaximum(50); spinBox->setMinimum(100); と設定した場合、setMaximum(50) の後に setMinimum(100) が呼び出されると、内部的に maximum も100に引き上げられ、結果的に range は (100, 100) になる可能性があります。
setRange() の使用: setMinimum() と setMaximum() を個別に呼び出す代わりに、setRange(minimum, maximum) メソッドを使用することを強く推奨します。これにより、最小値と最大値が原子的に設定され、矛盾した状態になることを防ぎます。
```
spinBox->setRange(0, 100); // これが最も安全な方法
```

エラー: 非常に大きな数値や小さな数値を扱いたい

現象: int 型の最大値や最小値を超えるような非常に大きな数値をQSpinBox::maximumとして設定できない。

原因: QSpinBox は内部的に int 型を使用しているため、int 型の範囲（通常、-2,147,483,648から2,147,483,647）に制限されます。

トラブルシューティング:

カスタムウィジェットの作成: int 型の範囲を超える整数値（例: 64ビット整数）を扱いたい場合は、QSpinBox を直接使用することはできません。QLineEdit を使用してテキスト入力させ、独自のバリデーションと変換ロジックを実装するか、QAbstractSpinBox を継承してカスタムのSpinBoxを作成する必要があります。これはより高度な作業になります。
QDoubleSpinBox の使用: 浮動小数点数（double型）を扱う必要がある場合は、QDoubleSpinBox を使用します。これにより、より大きな範囲の数値を表現できます（精度には限界があります）。

エラー: wrapping プロパティとの相互作用の誤解

現象: maximum に達した後に「上」ボタンを押すと、値が0（または minimum）に戻ってしまう。

原因: これはエラーではなく、wrapping プロパティが true に設定されている場合の意図された動作です。wrapping が有効な場合、値は最小値と最大値の間で循環します。

トラブルシューティング:

期待する動作の確認: 値が最大値に達したときにそれ以上増えないようにしたいのか、それとも最小値に戻るようにしたいのか、アプリケーションの要件を再確認してください。
wrapping の確認: spinBox->setWrapping(false); と設定されているか確認してください。デフォルトは false ですが、意図せず true に設定されている可能性があります。

QSpinBox::maximum は、QSpinBox ウィジェットが取りうる数値の最大値を設定するために使われます。ここでは、さまざまなシナリオにおけるコード例と、そのポイントを説明します。

例1: 基本的な `maximum` の設定

最も基本的な使用例です。QSpinBox を作成し、その最大値を設定します。

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

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

    QWidget window;
    QVBoxLayout *layout = new QVBoxLayout(&window);

    QSpinBox *spinBox = new QSpinBox(&window);

    // --- ここがポイント ---
    // QSpinBoxの最小値を0、最大値を100に設定します。
    // setRange()は、minimumとmaximumを同時に設定する推奨される方法です。
    spinBox->setRange(0, 100);

    // 初期値を設定します。
    // この値が設定範囲外の場合、自動的に範囲内に丸められます。
    spinBox->setValue(50);

    // ウィジェットのヒントを設定
    spinBox->setToolTip("0から100までの値を入力してください");

    layout->addWidget(spinBox);
    window.setLayout(layout);
    window.setWindowTitle("Basic QSpinBox Maximum Example");
    window.show();

    return app.exec();
}

解説:

spinBox->setRange(0, 100);
- この行で、QSpinBox が受け入れることができる最小値が0、最大値が100に設定されます。
- ユーザーは上下の矢印ボタンを使って値を増減させたり、手動で入力したりできますが、100より大きな値にはなりません。
- setRange() は setMinimum() と setMaximum() を個別に呼び出すよりも安全で推奨される方法です。

例2: `maximum` の動的な変更

アプリケーションのロジックに基づいて、実行時に maximum の値を変更する例です。

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

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

    QWidget window;
    QVBoxLayout *layout = new QVBoxLayout(&window);

    QLabel *label = new QLabel("現在の最大値: 100", &window);
    QSpinBox *spinBox = new QSpinBox(&window);
    QPushButton *increaseMaxButton = new QPushButton("最大値を200に設定", &window);
    QPushButton *resetMaxButton = new QPushButton("最大値を100に戻す", &window);

    spinBox->setRange(0, 100); // 初期設定
    spinBox->setValue(50);

    // --- ここがポイント ---
    // ボタンがクリックされたときにQSpinBoxの最大値を変更します。
    QObject::connect(increaseMaxButton, &QPushButton::clicked, [&]() {
        spinBox->setMaximum(200); // 最大値を200に設定
        label->setText("現在の最大値: 200");
    });

    QObject::connect(resetMaxButton, &QPushButton::clicked, [&]() {
        spinBox->setMaximum(100); // 最大値を100に戻す
        label->setText("現在の最大値: 100");
    });

    layout->addWidget(label);
    layout->addWidget(spinBox);
    layout->addWidget(increaseMaxButton);
    layout->addWidget(resetMaxButton);
    window.setLayout(layout);
    window.setWindowTitle("Dynamic Maximum Example");
    window.show();

    return app.exec();
}

解説:

spinBox->setMaximum(200); と spinBox->setMaximum(100);
- ボタンがクリックされるたびに、setMaximum() メソッドを使って QSpinBox の最大値が動的に変更されます。
- 最大値が変更されたときに、もし現在の value() が新しい maximum を超えている場合、value() は自動的に新しい maximum にクランプされます。例えば、最大値が200のときにspinBoxの値が150で、その後に最大値を100に設定し直すと、spinBoxの値は自動的に100になります。

例3: `wrapping` プロパティと `maximum`

wrapping プロパティは、値が最大値を超えたときに最小値に戻る（またはその逆）循環動作を制御します。

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

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

    QWidget window;
    QVBoxLayout *layout = new QVBoxLayout(&window);

    QLabel *label1 = new QLabel("通常モード (wrapping: false)", &window);
    QSpinBox *spinBoxNormal = new QSpinBox(&window);
    spinBoxNormal->setRange(0, 5); // 0-5の範囲
    spinBoxNormal->setValue(3);
    spinBoxNormal->setWrapping(false); // デフォルトですが明示的に

    QLabel *label2 = new QLabel("循環モード (wrapping: true)", &window);
    QSpinBox *spinBoxWrapped = new QSpinBox(&window);
    spinBoxWrapped->setRange(0, 5); // 0-5の範囲
    spinBoxWrapped->setValue(3);
    // --- ここがポイント ---
    // maximumに達したときにminimumに戻るように設定
    spinBoxWrapped->setWrapping(true);

    layout->addWidget(label1);
    layout->addWidget(spinBoxNormal);
    layout->addWidget(label2);
    layout->addWidget(spinBoxWrapped);
    window.setLayout(layout);
    window.setWindowTitle("QSpinBox Wrapping Example");
    window.show();

    return app.exec();
}

解説:

spinBoxWrapped->setWrapping(true);
- このSpinBoxでは、値が5に達した後に「上」の矢印ボタンを押すと、値は0に戻ります。逆に、値が0のときに「下」の矢印ボタンを押すと、値は5に戻ります。
- maximum の値が、循環の境界点として機能していることがわかります。
spinBoxNormal->setWrapping(false);
- このSpinBoxでは、値が5に達すると、それ以上「上」の矢印ボタンを押しても値は増えません。最大値で停止します。

例4: `maximum` と `value` の相互作用（値のクランプ）

setValue() を使って、maximum を超える値を設定しようとしたときの挙動を示す例です。

#include <QApplication>
#include <QSpinBox>
#include <QVBoxLayout>
#include <QLabel>
#include <QWidget>
#include <QDebug> // デバッグ出力用

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

    QWidget window;
    QVBoxLayout *layout = new QVBoxLayout(&window);

    QSpinBox *spinBox = new QSpinBox(&window);
    QLabel *resultLabel = new QLabel(&window);

    spinBox->setRange(0, 100); // 最大値を100に設定

    // --- ここがポイント ---
    // 最大値を超える値を設定しようとしています
    qDebug() << "Attempting to set value to 200...";
    spinBox->setValue(200); // 内部的に100に丸められます

    // 実際に設定された値を取得して表示
    int actualValue = spinBox->value();
    qDebug() << "Actual value after setValue(200): " << actualValue;
    resultLabel->setText(QString("設定を試みた値: 200\n実際に設定された値: %1").arg(actualValue));

    layout->addWidget(spinBox);
    layout->addWidget(resultLabel);
    window.setLayout(layout);
    window.setWindowTitle("Value Clamping Example");
    window.show();

    return app.exec();
}

解説:

spinBox->setValue(200);
- setMaximum(100) と設定されているため、setValue(200) を呼び出しても、実際のspinBox->value() は 100 になります。
- QSpinBox は、設定された値が許容範囲外の場合、自動的に範囲内にクランプ（丸め）します。これはエラーではなく、設計された挙動です。

QSpinBox::maximum は整数値の最大値を設定する最も直接的な方法ですが、アプリケーションの要件によっては、他のウィジェットやカスタムロジックを使用することがより適切であったり、別の方法で最大値の概念を扱う必要があったりします。

QDoubleSpinBox を使用する

いつ使うか:

int 型の範囲を超える非常に大きな整数値を、ある程度の精度で扱いたい場合（double型が表現できる整数値の精度には限界があります）。
整数ではなく浮動小数点数（小数）の最大値を扱いたい場合。

説明: QDoubleSpinBox は QSpinBox と同様に数値の増減を可能にするウィジェットですが、double 型の値を扱います。QSpinBox::maximum に対応する QDoubleSpinBox::maximum プロパティを持ちます。

コード例:

#include <QApplication>
#include <QDoubleSpinBox>
#include <QVBoxLayout>
#include <QWidget>

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

    QWidget window;
    QVBoxLayout *layout = new QVBoxLayout(&window);

    QDoubleSpinBox *doubleSpinBox = new QDoubleSpinBox(&window);

    // 最大値を設定（double型）
    doubleSpinBox->setRange(0.0, 100.5); // 最小値0.0、最大値100.5
    doubleSpinBox->setDecimals(2);       // 小数点以下2桁まで表示・入力可能に
    doubleSpinBox->setValue(50.25);

    layout->addWidget(doubleSpinBox);
    window.setLayout(layout);
    window.setWindowTitle("QDoubleSpinBox Example");
    window.show();

    return app.exec();
}

利点: 浮動小数点数を簡単に扱える。intの範囲を超える数値も表現できる（精度に注意）。欠点: 厳密な整数値を扱う場合は不向き。

QLineEdit と QValidator を組み合わせる

いつ使うか:

より複雑な入力規則を適用したい場合（例: 特定の範囲内の偶数のみ許可）。
QSpinBox では扱えない非常に大きな整数（例: 64ビット整数 long long）や、カスタムな入力形式（例: カンマ区切りなど）で最大値を制御したい場合。
QSpinBox のUI（矢印ボタンなど）が必要なく、テキスト入力だけで数値の入力を受け付けたい場合。

説明: QLineEdit は単行のテキスト入力ウィジェットです。これに QValidator（QIntValidator, QDoubleValidator, またはカスタムのバリデーター）を設定することで、入力できる文字や数値の範囲を制限できます。

コード例（QIntValidator で最大値を制限）:

#include <QApplication>
#include <QLineEdit>
#include <QVBoxLayout>
#include <QIntValidator>
#include <QLabel>
#include <QWidget>

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

    QWidget window;
    QVBoxLayout *layout = new QVBoxLayout(&window);

    QLabel *label = new QLabel("0から100までの整数を入力してください:", &window);
    QLineEdit *lineEdit = new QLineEdit(&window);

    // --- ここがポイント ---
    // QIntValidator を使用して、入力できる整数値の範囲を制限します
    // QIntValidator(bottom, top, parent)
    QIntValidator *validator = new QIntValidator(0, 100, lineEdit);
    lineEdit->setValidator(validator);

    // 初期値を設定（バリデーターの範囲外であれば、表示時に修正されることはないが、入力確定時にバリデートされる）
    lineEdit->setText("50");

    layout->addWidget(label);
    layout->addWidget(lineEdit);
    window.setLayout(layout);
    window.setWindowTitle("QLineEdit with QIntValidator Example");
    window.show();

    return app.exec();
}

利点:

非常に柔軟なバリデーションロジックを実装できる。
QSpinBoxのUIが不要な場合にシンプル。
int型以外の大きな整数（long longなど）やカスタム形式の文字列入力を扱える。

欠点:

バリデーションは通常、入力確定時（フォーカスが外れたりEnterキーが押されたりしたとき）に行われるため、リアルタイムのフィードバックがQSpinBoxほど直感的ではない場合がある。
矢印ボタンによる値の増減機能がないため、ユーザーが手動で数値を入力する必要がある。

スライダー (QSlider) と数値表示を組み合わせる

いつ使うか:

ユーザーが視覚的に範囲を把握し、直感的に値を調整できるようにしたい場合。
数値の大まかな範囲選択が目的で、正確な数値入力は二の次である場合。

説明: QSlider は、一定の範囲内で値をスライドさせて選択するウィジェットです。QSpinBox::maximum に対応する QSlider::maximum プロパティを持ちます。これに QLabel や読み取り専用の QLineEdit を組み合わせて現在の値を表示すると、数値入力ウィジェットのような機能を実現できます。

コード例:

#include <QApplication>
#include <QSlider>
#include <QLabel>
#include <QVBoxLayout>
#include <QWidget>
#include <QDebug>

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

    QWidget window;
    QVBoxLayout *layout = new QVBoxLayout(&window);

    QLabel *valueLabel = new QLabel("選択中の値: 50", &window);
    QSlider *slider = new QSlider(Qt::Horizontal, &window); // 水平スライダー

    // --- ここがポイント ---
    // スライダーの最小値と最大値を設定
    slider->setRange(0, 100);
    slider->setValue(50);
    slider->setTickPosition(QSlider::TicksBothSides); // 目盛りを表示

    // スライダーの値が変更されたときにラベルを更新
    QObject::connect(slider, &QSlider::valueChanged, [&](int value) {
        valueLabel->setText(QString("選択中の値: %1").arg(value));
    });

    layout->addWidget(valueLabel);
    layout->addWidget(slider);
    window.setLayout(layout);
    window.setWindowTitle("QSlider with Value Display Example");
    window.show();

    return app.exec();
}

利点: 視覚的で直感的な操作が可能。広範囲から大まかな値を選択するのに適している。欠点: 正確な数値の入力には向かない。

QComboBox / QListWidget で選択肢を提供する

いつ使うか:

ユーザーに自由な数値入力をさせず、あらかじめ定義された値のみを選択させたい場合。
最大値が固定された、少数の離散的な選択肢の中から値を選ばせたい場合。

説明: QComboBox はドロップダウンリストから選択肢を選ぶウィジェットです。QListWidget はリスト形式で選択肢を表示します。これらに数値の選択肢を追加し、選択されたアイテムに対応する値を取得します。

コード例:

#include <QApplication>
#include <QComboBox>
#include <QLabel>
#include <QVBoxLayout>
#include <QWidget>
#include <QStringList> // 項目リスト用

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

    QWidget window;
    QVBoxLayout *layout = new QVBoxLayout(&window);

    QLabel *label = new QLabel("数量を選択してください:", &window);
    QComboBox *comboBox = new QComboBox(&window);

    // --- ここがポイント ---
    // ドロップダウンリストに数値の選択肢を追加
    // 実際にはQStringで表示するが、内部的にint値などに関連付ける
    comboBox->addItem("1個", 1);    // 表示テキストと関連データ（int）
    comboBox->addItem("5個", 5);
    comboBox->addItem("10個", 10);
    comboBox->addItem("最大 (50個)", 50); // これが最大値の概念

    // 選択された項目に基づいてラベルを更新
    QObject::connect(comboBox, QOverload<int>::of(&QComboBox::currentIndexChanged),
                     [&](int index) {
        int selectedValue = comboBox->itemData(index).toInt();
        label->setText(QString("選択された数量: %1個").arg(selectedValue));
    });

    // 初期選択
    comboBox->setCurrentIndex(0);

    layout->addWidget(label);
    layout->addWidget(comboBox);
    window.setLayout(layout);
    window.setWindowTitle("QComboBox as Number Selector Example");
    window.show();

    return app.exec();
}

利点: ユーザーに選択肢を提示し、入力ミスを防ぐ。自由な数値入力をさせたくない場合に最適。欠点: 選択肢の数が多い場合に不便。固定された値しか選択できない。

カスタムウィジェットの作成 (QAbstractSpinBox を継承)

いつ使うか:

QSpinBox の見た目や動作を根本的に変更したい場合。
QSpinBox や QDoubleSpinBox の基本的な機能は欲しいが、デフォルトの挙動では実現できない特殊な数値入力のニーズがある場合（例: 非常に大きな数の表示、カスタムの進捗表示、非線形な増減）。

説明: QAbstractSpinBox は、QSpinBox や QDoubleSpinBox の基底クラスです。これを継承して独自のSpinBoxを実装することで、stepBy(), textFromValue(), valueFromText(), validate() などの仮想関数をオーバーライドし、最大値の概念を非常に柔軟に制御できます。これは最も高度な代替手段です。

利点: 究極の柔軟性。欠点: 実装が複雑で時間がかかる。

Qt QSpinBoxの「最大値」を使いこなす：コード例とトラブルシューティング

QSpinBox::maximum とは

役割

設定方法

関連するプロパティ・メソッド

エラー: setValue() で設定した値が maximum を超えてしまう

エラー: maximum を設定したのに、入力が制限されない（特に手動入力時）

エラー: minimum と maximum の関係性に関する問題

エラー: 非常に大きな数値や小さな数値を扱いたい

エラー: wrapping プロパティとの相互作用の誤解

例1: 基本的な maximum の設定

例2: maximum の動的な変更

例3: wrapping プロパティと maximum

例4: maximum と value の相互作用（値のクランプ）

QDoubleSpinBox を使用する

QLineEdit と QValidator を組み合わせる

スライダー (QSlider) と数値表示を組み合わせる

QComboBox / QListWidget で選択肢を提供する

カスタムウィジェットの作成 (QAbstractSpinBox を継承)

例1: 基本的な `maximum` の設定

例2: `maximum` の動的な変更

例3: `wrapping` プロパティと `maximum`

例4: `maximum` と `value` の相互作用（値のクランプ）