DoubleSpinBox QML Type

사용자가 미리 설정된 부동 소수점 값 집합에서 선택할 수 있습니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• decimals : int
• displayText : string
• down
  • down.hovered : bool
  • down.implicitIndicatorHeight : real
  • down.implicitIndicatorWidth : real
  • down.indicator : Item
  • down.pressed : bool
• editable : bool
• from : double
• inputMethodComposing : bool
• inputMethodHints : flags (since QtQuick.Controls 2.2 (Qt 5.9))
• stepSize : double
• textFromValue : function
• to : int
• up
  • up.hovered : bool
  • up.implicitIndicatorHeight : real
  • up.implicitIndicatorWidth : real
  • up.indicator : Item
  • up.pressed : bool
• validator : Validator
• value : double
• valueFromText : function
• wrap : bool (since QtQuick.Controls 2.3 (Qt 5.10))

신호

• valueModified()

방법

• void decrease()
• void increase()

자세한 설명

DoubleSpinBox는 SpinBox 과 유사하지만 정수가 아닌 이중 값을 지원한다는 점이 다릅니다. 사용자는 위쪽 또는 아래쪽 표시기 버튼을 클릭하거나 키보드의 위쪽 또는 아래쪽을 눌러 값을 선택할 수 있습니다. 선택적으로 사용자가 입력 필드에 텍스트 값을 입력할 수 있도록 DoubleSpinBox를 editable 로 만들 수도 있습니다.

기본적으로 DoubleSpinBox는 [0.00-99.99] 범위의 불연속 값과 stepSize 의 1.0 를 제공합니다.

DoubleSpinBox {
    id: doubleSpinBox
    from: 0
    value: 1.1
    to: 100
    stepSize: Math.pow(10, -decimals)
    decimals: 2
    editable: true
    anchors.centerIn: parent
}

SpinBox, Tumbler, DoubleSpinBox 사용자 정의 및 Qt Quick Controls 의 포커스 관리도참조하세요 .

속성 문서

decimals : int

이 속성은 스핀박스가 복수를 표시하고 해석하는 데 사용할 소수점 수를 저장합니다.

기본값은 2 입니다.

이 속성의 값을 변경하면 from, to 및 value 에 영향을 줄 수 있습니다.

displayText : string [read-only]

이 속성은 스핀박스의 텍스트 값을 보유합니다.

이 속성의 값은 textFromValue 및 locale 을 기준으로 하며 다음과 같습니다:

let text = spinBox.textFromValue(spinBox.value, spinBox.decimals, spinBox.locale)

textFromValue 를참조하세요 .

down group

이 그룹화된 속성은 아래쪽 표시기 항목과 관련 속성을 보유합니다.

decrease()도 참조하세요 .

editable : bool

이 속성은 스핀박스를 편집할 수 있는지 여부를 저장합니다. 기본값은 false 입니다.

validator 를참조하세요 .

from : double

이 속성은 범위의 시작 값을 보유합니다. 기본값은 0.0 입니다.

to 및 value 을참조하세요 .

inputMethodComposing : bool [read-only]

이 속성은 편집 가능한 스핀 상자에 입력 메서드에서 부분 텍스트 입력이 있는지 여부를 보유합니다.

입력 메서드는 작성하는 동안 스핀 상자의 마우스 또는 키 이벤트에 의존하여 부분 텍스트를 편집하거나 커밋할 수 있습니다. 이 속성은 입력 메서드의 올바른 작동을 방해할 수 있는 이벤트 핸들러를 비활성화할 시기를 결정하는 데 사용할 수 있습니다.

inputMethodHints : flags [since QtQuick.Controls 2.2 (Qt 5.9)]

이 속성은 스핀 박스의 예상 콘텐츠와 작동 방식에 대한 입력 메서드에 힌트를 제공합니다.

기본값은 Qt.ImhDigitsOnly 입니다.

이 값은 비트 단위의 플래그 조합이며 힌트가 설정되지 않은 경우 Qt.ImhNone 입니다.

동작을 변경하는 플래그는 다음과 같습니다:

• Qt.ImhHiddenText - 일반적으로 비밀번호를 입력할 때 사용되는 것처럼 문자를 숨겨야 합니다.
• Qt.ImhSensitiveData - 입력된 텍스트가 예측 사용자 사전과 같은 영구 저장소에 활성 입력 방법으로 저장되어서는 안 됩니다.
• Qt.ImhNoAutoUppercase - 입력 메서드가 문장이 끝날 때 자동으로 대문자로 전환하려고 시도하지 않아야 합니다.
• Qt.ImhPreferNumbers - 숫자를 선호합니다(필수는 아님).
• Qt.ImhPreferUppercase - 대문자를 선호합니다(필수는 아님).
• Qt.ImhPreferLowercase - 소문자를 선호합니다(필수는 아님).
• Qt.ImhNoPredictiveText - 입력하는 동안 예측 텍스트(예: 사전 조회)를 사용하지 않습니다.
• Qt.ImhDate - 텍스트 편집기가 날짜 필드로 작동합니다.
• Qt.ImhTime - 텍스트 편집기가 시간 필드로 작동합니다.

입력을 제한하는 플래그(독점 플래그)는 다음과 같습니다:

• Qt.ImhDigitsOnly - 숫자만 허용됩니다.
• Qt.ImhFormattedNumbersOnly - 숫자 입력만 허용됩니다. 여기에는 소수점과 빼기 기호가 포함됩니다.
• Qt.ImhUppercaseOnly - 대문자 입력만 허용합니다.
• Qt.ImhLowercaseOnly - 소문자 입력만 허용합니다.
• Qt.ImhDialableCharactersOnly - 전화 다이얼링에 적합한 문자만 허용합니다.
• Qt.ImhEmailCharactersOnly - 이메일 주소에 적합한 문자만 허용합니다.
• Qt.ImhUrlCharactersOnly - URL에 적합한 문자만 허용됩니다.

Masks:

• Qt.ImhExclusiveInputMask - 이 마스크는 독점 플래그 중 하나라도 사용되면 0이 아닌 값을 반환합니다.

이 속성은 QtQuick.Controls 2.2(Qt 5.9)에 도입되었습니다.

stepSize : double

이 속성은 스텝 크기를 저장합니다. 기본값은 1.0 입니다.

increase() 및 decrease()도 참조하세요 .

textFromValue : function

이 프로퍼티에는 텍스트를 표시하기 위해 이중 값을 변환해야 할 때마다 호출되는 콜백 함수가 있습니다.

기본 함수를 재정의하여 지정된 값에 대한 사용자 지정 텍스트를 표시할 수 있습니다. 이는 편집 가능한 스핀박스와 편집 불가능한 스핀박스 모두에 적용되며, 예를 들어 위쪽 및 아래쪽 버튼이나 마우스 휠을 사용하여 값을 늘리거나 줄일 때 이 함수를 사용하여 새 값이 텍스트를 표시하도록 변환됩니다.

콜백 함수 시그니처는 string function(value, decimals, locale) 입니다. 이 함수에는 두 개 또는 세 개의 인수가 있을 수 있는데, 첫 번째 인수는 변환할 값, 두 번째 인수는 소수점 수, 선택적 세 번째 인수는 변환에 사용할 로캘(해당하는 경우)입니다.

기본 구현은 Number.toLocaleString()을 사용하여 변환을 수행합니다:

textFromValue: function(value, decimals, locale) {
    return Number(value).toLocaleString(locale, 'f', decimals);
}

valueFromText, validator, locale 를참조하세요 .

to : int

이 속성은 범위의 끝값을 보유합니다. 기본값은 2 입니다.

from 및 value 을참조하세요 .

up group

이 그룹화된 속성은 위쪽 표시기 항목과 관련 속성을 보유합니다.

increase()도 참조하세요 .

validator : Validator

이 속성은 편집 가능한 스핀박스에 대한 입력 텍스트 유효성 검사기를 보유합니다. 기본적으로 DoubleSpinBox 은 DoubleValidator 을 사용하여 이중 숫자의 입력을 허용합니다.

DoubleSpinBox {
    id: control
    validator: DoubleValidator {
        locale: control.locale.name
        bottom: Math.min(control.from, control.to)
        top: Math.max(control.from, control.to)
    }
}

editable, textFromValue, valueFromText, locale 및 입력 텍스트 유효성검사도 참조하세요 .

value : double

이 속성은 from - to 범위의 값을 보유합니다. 기본값은 0.0 입니다.

valueFromText : function

이 속성에는 입력 텍스트를 이중 값으로 변환해야 할 때마다 호출되는 콜백 함수가 있습니다.

이 함수는 편집 가능한 스핀박스에 대해 textFromValue 을 재정의할 때만 재정의하면 됩니다.

콜백 함수 시그니처는 int function(text, locale) 입니다. 이 함수에는 하나 또는 두 개의 인수가 있을 수 있으며, 첫 번째 인수는 변환할 텍스트이고 선택적 두 번째 인수는 해당하는 경우 변환에 사용해야 하는 로캘입니다.

기본 구현은 Number.fromLocaleString() 을 사용하여 변환합니다:

valueFromText: function(text, locale) { return Number.fromLocaleString(locale, text); }

textFromValue, validator, locale도 참조하세요 .

wrap : bool [since QtQuick.Controls 2.3 (Qt 5.10)]

이 속성은 스핀박스의 래핑 여부를 보유합니다. 기본값은 false 입니다.

줄 바꿈이 true 인 경우 to 을 지나면 값이 from 로 변경되고 그 반대의 경우도 마찬가지입니다.

이 프로퍼티는 QtQuick.Controls 2.3(Qt 5.10)에서 도입되었습니다.

신호 문서

valueModified()

이 신호는 사용자가 터치, 마우스, 휠 또는 키를 사용하여 스핀 박스 값을 대화형으로 수정했을 때 발생합니다. 키보드를 통한 상호작용의 경우 텍스트가 수락된 경우, 즉 엔터 또는 리턴 키를 누르거나 입력 필드가 포커스를 잃었을 때만 신호가 발생합니다.

메서드 문서

void decrease()

stepSize 또는 stepSize 이 정의되지 않은 경우 1 만큼 값을 줄입니다.

stepSize도 참조하세요 .

void increase()

stepSize 또는 stepSize 이 정의되지 않은 경우 1 만큼 값을 증가시킵니다.

stepSize도 참조하세요 .