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 값을 단 한 번의 함수 호출로 설정할 수 있는 편리한 함수입니다.

참고: 최대값과 최소값은 decimals 속성에 맞춰 반올림됩니다.

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()이 설정되지 않은 경우 천 단위 구분자를 제거합니다. 재구현된 함수는 임의의 값을 반환할 수 있습니다.

참고: QDoubleSpinBox 는 specialValueText()에 대해서는 이 함수를 호출하지 않으며, 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()도 참조하십시오 .