SpinBox QML Type

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

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

var text = spinBox.textFromValue(spinBox.value, spinBox.locale)

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

textFromValue도 참조하십시오 .

이 속성은 아래쪽 표시기 항목과 해당 항목이 눌렀는지 또는 가리키고 있는지 여부를 유지합니다. down.hovered 속성은 QtQuick.Controls 2.1에 도입되었고 down.implicitIndicatorWidth 및 down.implicitIndicatorHeight 속성은 QtQuick.Controls 2.5에 도입되었습니다.

decrease()도 참조하세요 .

이 속성은 스핀박스의 편집 가능 여부를 보유합니다. 기본값은 false 입니다.

validator 를참조하십시오 .

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

to 및 value 을참조하세요 .

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

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

이 프로퍼티는 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)에 도입되었습니다.

이 속성은 사용자가 displayText 을 편집할 때 value 이 업데이트되는지 여부를 보유합니다. 기본값은 false 입니다. 이 속성이 true 이고 사용자가 입력한 값이 유효하고 스핀박스 [from, to] 범위 내에 있으면 SpinBox 의 값이 설정됩니다. 이 속성이 false 이거나 사용자가 입력한 값이 경계를 벗어난 경우, 입력 또는 리턴 키를 누르거나 입력 필드의 포커스가 사라질 때까지 값이 업데이트되지 않습니다.

이 속성은 Qt 6.6에 도입되었습니다.

editable 및 displayText 을참조하십시오 .

이 속성은 단계 크기를 보유합니다. 기본값은 1 입니다.

increase() 및 decrease()도 참조하십시오 .

이 프로퍼티는 텍스트를 표시하기 위해 정수 값을 변환해야 할 때마다 호출되는 콜백 함수를 보유합니다.

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

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

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

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

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

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

from 및 value도 참조 하세요.

이 속성은 위쪽 표시기 항목과 해당 항목이 눌렀는지 또는 마우스오버되었는지 여부를 유지합니다. up.hovered 속성은 QtQuick.Controls 2.1에 도입되었고 up.implicitIndicatorWidth 및 up.implicitIndicatorHeight 속성은 QtQuick.Controls 2.5에 도입되었습니다.

increase()도 참조하세요 .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

이 신호는 QtQuick.Controls 2.2(Qt 5.9)에서 도입되었습니다.

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

stepSize도 참조하십시오 .

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

stepSize도 참조 하세요.