QDoubleSpinBox Class

멤버 함수 문서

[explicit] QDoubleSpinBox::QDoubleSpinBox(QWidget *parent = nullptr)

최소값은 0.0, 최대값은 99.99, 단계 값은 1.0, 정밀도는 소수점 이하 2자리인 스핀 박스를 구성합니다. 값은 처음에 0.00으로 설정됩니다. 스핀 상자는 parent 로 지정됩니다.

setMinimum(), setMaximum() 및 setSingleStep()도 참조하세요 .

[virtual noexcept] QDoubleSpinBox::~QDoubleSpinBox()

파괴자.

[override virtual] void QDoubleSpinBox::fixup(QString &input) const

재구현합니다: QAbstractSpinBox::fixup(QString &input) const.

void QDoubleSpinBox::setRange(double minimum, double maximum)

편의 함수를 사용하면 한 번의 함수 호출로 minimum 및 maximum 값을 설정할 수 있습니다.

참고: 최대값과 최소값은 소수점 속성과 일치하도록 반올림됩니다.

setRange(minimum, maximum);

와 동일합니다:

setMinimum(minimum);
setMaximum(maximum);

minimum 및 maximum 을참조하세요 .

void QDoubleSpinBox::setStepType(QAbstractSpinBox::StepType stepType)

스핀 박스의 단계 유형을 단일 단계 또는 적응형 소수점 단계인 stepType 로 설정합니다.

적응형 소수점 단계는 단계 크기가 현재 value 보다 10의 1승 이하로 계속 조정되는 것을 의미합니다. 따라서 값이 1100이면 스텝이 100으로 설정되어 있으므로 한 단계 올리면 1200으로 증가합니다. 1200의 경우 한 번 더 올리면 1300이 됩니다. 음수 값의 경우 -1100에서 스텝다운하면 -1200이 됩니다.

모든 소수점 값에 대해서도 작동하며, 0.041은 한 단계씩 올리면 0.042로 증가합니다.

에지 케이스를 처리하기 위해 스텝 방향이 고려되므로 100에서 스텝다운하면 값이 90이 아닌 99가 됩니다. 따라서 스텝업 후 스텝다운 또는 그 반대의 경우 항상 99 -> 100 -> 99의 시작 값에 도달합니다.

이렇게 설정하면 스핀 박스가 singleStep 값을 무시하게 되지만, 나중에 적응형 소수점 단계가 꺼진 경우 singleStep 값이 적용되도록 보존됩니다.

stepType()도 참조하세요 .

[signal] void QDoubleSpinBox::textChanged(const QString &text)

이 신호는 스핀 박스의 텍스트가 변경될 때마다 발생합니다. 새 텍스트는 prefix() 및 suffix()와 함께 text 에 전달됩니다.

[virtual] QString QDoubleSpinBox::textFromValue(double value) const

이 가상 함수는 주어진 value 을 표시해야 할 때마다 스핀 박스에서 사용됩니다. 기본 구현은 QWidget::locale()를 사용하여 출력된 value 을 포함하는 문자열을 반환합니다.toString(value, u'f', decimals())은 setGroupSeparatorShown()를 설정하지 않으면 천 단위 구분 기호를 제거합니다. 재구현하면 아무 것도 반환할 수 있습니다.

참고: specialValueText()에 대해서는 QDoubleSpinBox 이 함수를 호출하지 않으며 prefix() 또는 suffix()도 반환값에 포함되어서는 안 됩니다.

이를 다시 구현하는 경우 valueFromText()도 다시 구현해야 할 수 있습니다.

valueFromText() 및 QLocale::groupSeparator()도 참조하세요 .

[override virtual] QValidator::State QDoubleSpinBox::validate(QString &text, int &pos) const

재구현합니다: QAbstractSpinBox::validate(QString &input, int &pos) const.

[signal] void QDoubleSpinBox::valueChanged(double d)

이 신호는 스핀 박스의 값이 변경될 때마다 발생합니다. 새 값은 d 에 전달됩니다.

[virtual] double QDoubleSpinBox::valueFromText(const QString &text) const

이 가상 함수는 스핀 박스가 사용자가 입력한 text 을 값으로 해석해야 할 때마다 사용됩니다.

숫자가 아닌 방식으로 스핀 박스 값을 표시해야 하는 서브클래스는 이 함수를 다시 구현해야 합니다.

참고: QDoubleSpinBox 는 specialValueText()를 별도로 처리하며, 이 함수는 다른 값과만 관련이 있습니다.

textFromValue() 및 validate()도 참조하세요 .