Qt WidgetsにおけるQDoubleSpinBox::decimals解説

Qt WidgetsにおけるQDoubleSpinBox::decimals解説

QDoubleSpinBox は、Qt Widgets モジュールで提供される、浮動小数点数の値を入力するためのスピンボックスウィジェットです。 decimals プロパティは、スピンボックスで表示される小数点以下の桁数を制御します。

設定方法

decimals プロパティは、以下の方法で設定できます。

• コードによる設定

QDoubleSpinBox spinBox;

// 小数点以下の桁数を2桁に設定
spinBox.setDecimals(2);

// 現在の小数点以下の桁数を取得
int decimals = spinBox.decimals();

• Qt Designerによる設定

Qt Designer で QDoubleSpinBox ウィジェットを選択し、プロパティエディタの decimals プロパティで値を設定できます。

値の範囲

decimals プロパティは、0からスピンボックスの最大値までの範囲で設定できます。デフォルト値は0です。

小数点以下の桁数の影響

decimals プロパティを設定すると、以下の影響があります。

• スピンボックスに表示される値

スピンボックスに表示される値は、設定された小数点以下の桁数で丸められます。

• value() メソッドによる値の取得

value() メソッドで取得される値は、設定された小数点以下の桁数で丸められます。

• setValue() メソッドによる値の設定

setValue() メソッドで設定する値は、設定された小数点以下の桁数で丸められます。

例

以下の例は、decimals プロパティを設定して、小数点以下の桁数を2桁に制限するコードです。

QDoubleSpinBox spinBox;

// 小数点以下の桁数を2桁に設定
spinBox.setDecimals(2);

// 値を1.2345に設定
spinBox.setValue(1.2345);

// スピンボックスに表示される値は1.23
qDebug() << spinBox.value();

補足

• decimals プロパティは、minimum プロパティと maximum プロパティの影響を受けます。
• decimals プロパティを設定しても、スピンボックスに入力できる値の範囲は変わりません。

QDoubleSpinBox::decimalsを使用したサンプルコード

QDoubleSpinBox spinBox;

// 小数点以下の桁数を2桁に設定
spinBox.setDecimals(2);

// 値を1.2345に設定
spinBox.setValue(1.2345);

// スピンボックスに表示される値は1.23
qDebug() << spinBox.value();

スピンボックスに入力できる値の範囲を0から100までの範囲で、小数点以下の桁数を2桁に制限する

QDoubleSpinBox spinBox;

// スピンボックスの最小値を0に設定
spinBox.setMinimum(0.0);

// スピンボックスの最大値を100に設定
spinBox.setMaximum(100.0);

// 小数点以下の桁数を2桁に設定
spinBox.setDecimals(2);

// 値を50.12345に設定
spinBox.setValue(50.12345);

// スピンボックスに表示される値は50.12
qDebug() << spinBox.value();

スピンボックスに入力できる値の範囲を0から100までの範囲で、小数点以下の桁数を1桁に制限する

QDoubleSpinBox spinBox;

// スピンボックスの最小値を0に設定
spinBox.setMinimum(0.0);

// スピンボックスの最大値を100に設定
spinBox.setMaximum(100.0);

// 小数点以下の桁数を1桁に設定
spinBox.setDecimals(1);

// 値を50.12345に設定
spinBox.setValue(50.12345);

// スピンボックスに表示される値は50.1
qDebug() << spinBox.value();

スピンボックスに入力できる値を整数に制限する

QDoubleSpinBox spinBox;

// スピンボックスの最小値を0に設定
spinBox.setMinimum(0.0);

// スピンボックスの最大値を100に設定
spinBox.setMaximum(100.0);

// 小数点以下の桁数を0に設定
spinBox.setDecimals(0);

// 値を50.12345に設定
spinBox.setValue(50.12345);

// スピンボックスに表示される値は50
qDebug() << spinBox.value();

スピンボックスに入力できる値を0から100までの範囲で、小数点以下の桁数をユーザーが入力できるようにする

QDoubleSpinBox spinBox;

// スピンボックスの最小値を0に設定
spinBox.setMinimum(0.0);

// スピンボックスの最大値を100に設定
spinBox.setMaximum(100.0);

// 小数点以下の桁数をユーザーが入力できるように設定
spinBox.setDecimals(-1);

// 値を50.12345に設定
spinBox.setValue(50.12345);

// スピンボックスに表示される値は50.12345
qDebug() << spinBox.value();

スピンボックスの値が変化したときにスロットを実行する

QDoubleSpinBox spinBox;

// スピンボックスの値が変化したときに呼び出されるスロット
void onValueChanged(double value)
{
  // スピンボックスの現在の値を出力
  qDebug() << value;
}

// スピンボックスの値が変化したときにonValueChanged()スロットを実行
QObject::connect(&spinBox, &QDoubleSpinBox::valueChanged, onValueChanged);

// 値を50.12345に設定
spinBox.setValue(50.12345);

これらのサンプルコードは、QDoubleSpinBox::decimals プロパティの使い方を理解するのに役立ちます。

QDoubleSpinBox::decimals 以外の方法

QDoubleValidator クラスを使用して、スピンボックスに入力できる値を制限することができます。

QDoubleSpinBox spinBox;

// 小数点以下の桁数を2桁に制限するバリデータを作成
QDoubleValidator validator(0, 100, 2);

// スピンボックスにバリデータを設定
spinBox.setValidator(&validator);

// 値を1.2345に設定
spinBox.setValue(1.2345);

// スピンボックスに表示される値は1.23
qDebug() << spinBox.value();

QLineEdit を使用する

QLineEdit ウィジェットを使用して、浮動小数点数の値を入力することができます。

QLineEdit lineEdit;

// 入力できる値を0から100までの範囲で、小数点以下の桁数を2桁に制限
lineEdit.setValidator(new QDoubleValidator(0, 100, 2));

// 値を1.2345に設定
lineEdit.setText("1.2345");

// 入力された値を取得
QString text = lineEdit.text();

// 値をdouble型に変換
double value = text.toDouble();

// 値を出力
qDebug() << value;

自身のコードで検証を行う

QDoubleSpinBox::valueChanged() シグナルを使用して、スピンボックスの値が変化したことを検知し、自身のコードで検証を行うことができます。

QDoubleSpinBox spinBox;

void onValueChanged(double value)
{
  // 値が有効かどうかを検証
  if (value < 0 || value > 100) {
    // 無効な値の場合はスピンボックスの値を元に戻す
    spinBox.setValue(m_previousValue);
    return;
  }

  // 有効な値の場合はm_previousValueを更新
  m_previousValue = value;
}

// スピンボックスの値が変化したときにonValueChanged()スロットを実行
QObject::connect(&spinBox, &QDoubleSpinBox::valueChanged, onValueChanged);

// 値を50.12345に設定
spinBox.setValue(50.12345);

これらの方法は、QDoubleSpinBox::decimals プロパティを使用するよりも柔軟な方法で、スピンボックスに入力できる値を制限することができます。