NumberBox QML Type
一个用于输入和调整数值的控件，支持小步增减和大步增减功能。. More...
| Import Statement: | import FluentUI.Controls 1.0 |
Properties
- activeFocus : bool
- compactPopup : Item
- enabled : bool
- hovered : bool
- largeChange : real
- max : var
- min : var
- placementMode : int
- precision : int
- smallChange : real
- trailing : Item
- value : var
Signals
- valueChanged(var newValue)
- valueInvalid(var invalidValue)
- valueOutOfRange(var outOfRangeValue)
Detailed Description
NumberBox 组件是一个用于输入和调整数值的控件，提供了多种操作方式，包括小步增减、大步增减和手动输入。它支持整数和浮点数的输入，并能够根据配置的最小值和最大值进行限制。
该组件支持两种放置模式：Inline 和 Compact。Inline 模式下，控件会显示额外的操作按钮，而 Compact 模式下，控件会展示一个弹出式的选择框。用户可以通过键盘和鼠标滚轮来调整数值。
示例用法：
NumberBox { placementMode: NumberBoxType.Inline min: 0 max: 100 value: 50 smallChange: 0.1 largeChange: 1 precision: 2 }
Property Documentation
activeFocus : bool |
控件是否具有焦点。用于控制控件在具有焦点时的视觉效果。
compactPopup : Item |
在 Compact 模式下显示的弹出式组件。包括上下增减按钮和其他相关控件。
enabled : bool |
控件是否可用。设置为 false 时，控件将不可交互并显示禁用状态。
hovered : bool |
控件是否被鼠标悬停。用于控制控件在鼠标悬停时的视觉效果。
largeChange : real |
大步增减的数值。例如，按下 Page Up 或 Page Down 键时增减的量。
max : var |
控件允许的最大数值。如果未设置或为 null，则没有最大限制。
min : var |
控件允许的最小数值。如果未设置或为 null，则没有最小限制。
placementMode : int |
控件的放置模式。可以是 NumberBoxType.Inline 或 NumberBoxType.Compact。
precision : int |
数值的精度（小数位数）。用于格式化显示的数值。
smallChange : real |
小步增减的数值。例如，点击增减按钮时每次增减的量。
trailing : Item |
在控件右侧显示的自定义组件。在 Inline 模式下可见。
value : var |
当前的数值。控件显示和操作的数值。
Signal Documentation
valueChanged(var newValue) |
当数值发生变化时发射的信号。传递的新值作为参数。
Note: The corresponding handler is onValueChanged.
valueInvalid(var invalidValue) |
当输入的数值无效时发射的信号。传递的无效值作为参数。
Note: The corresponding handler is onValueInvalid.
valueOutOfRange(var outOfRangeValue) |
当输入的数值超出设置的范围（最小值或最大值）时发射的信号。传递的超出范围的值作为参数。
Note: The corresponding handler is onValueOutOfRange.