SpinBox QML Type

该属性用于保存 Spinbox 的文本值。

该属性的值基于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 - 输入的文本不应由 Active 输入法存储在任何持久性存储中，如预测用户字典。
• 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 的字符。

掩码：

• Qt.ImhExclusiveInputMask - 如果使用了任何独占标志，该掩码将产生非零值。

该属性在 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 。

如果 wrap 为true ，则走过to 后，值会变为from ，反之亦然。

此属性在 QtQuick.Controls 2.3 (Qt 5.10) 中引入。

当用户通过触摸、鼠标、滚轮或按键对旋转框的值进行交互式修改时，就会发出该信号。在通过键盘交互的情况下，只有当文本被接受（即按下回车键或回车键或输入框失去焦点）时，才会发出该信号。

该信号在 QtQuick.Controls 2.2 (Qt 5.9) 中引入。

通过stepSize 或1 （如果stepSize 未定义）减小数值。

另请参阅 stepSize 。

通过stepSize 或1 （如果stepSize 未定义）增加数值。

另请参阅 stepSize 。