Version 1.0.1 adds two-way variable binding. A variable assigned in the properties panel initializes the control when it contains a valid number, and user edits, spinner buttons, and actions write the new value back automatically.
1. Overview & Purpose
The neoInputNumber plugin provides a modern numeric entry box control complete with integrated spin buttons (up/down arrows), exact vertical text centering regardless of container height, step size increments, range validation (minValue, maxValue), decimal precision formatting, and host Style Palette integration.
2. Custom Control Properties
Control: neoInputNumber (neo-input-number)
| Property Name | Type | Default Value | Description |
|---|---|---|---|
| variable | variable | "" | Optional VisualNEO variable (e.g. [MyNumber]) bound directly to the numeric value. |
value | number | 0 | Active numeric value. |
minValue | number | 0 | Minimum allowable value. |
maxValue | number | 100 | Maximum allowable value. |
step | number | 1 | Increment/decrement step size per spin arrow click. |
decimals | integer | 0 | Number of decimal display digits (0 for integers). |
readOnly | boolean | false | Disables user editing while keeping actions available. |
3. Actions & Commands Reference
neoInputNumberSetValue
Sets the numeric value of a neoInputNumber control.
- Command Syntax:
neoInputNumberSetValue "ObjectName" "NumericValue"
neoInputNumberGetValue
Retrieves the current numeric value into [neoInputNumberResult] (and optionally into a specified variable).
- Command Syntax:
neoInputNumberGetValue "ObjectName" "[ResultVar]" - Parameters:
- •
ObjectName(string): Target control name. - •
ResultVar(string, optional): Variable to receive the numeric string (e.g."[Quantity]").
neoInputNumberSetRange
Sets the minimum and maximum allowable numeric values.
- Command Syntax:
neoInputNumberSetRange "ObjectName" "MinValue" "MaxValue"
neoInputNumberSetStep
Sets the spin step increment size.
- Command Syntax:
neoInputNumberSetStep "ObjectName" "StepSize"
neoInputNumberFocus
Moves keyboard focus to the numeric input field.
- Command Syntax:
neoInputNumberFocus "ObjectName"
4. Events Reference
change: Fires when the user edits or increments/decrements the value.commit: Fires when the user presses Enter or leaves the field.invalid: Fires when an entry breaks range constraints.
5. Practical Usage Example (VisualNEO Win Script)
. --- Configure quantity spin box ---
neoInputNumberSetRange "InputNumber1" "1" "100"
neoInputNumberSetStep "InputNumber1" "5"
neoInputNumberSetValue "InputNumber1" "10"
. --- Retrieve total value ---
neoInputNumberGetValue "InputNumber1"
SetVar "[SelectedQuantity]" "[neoInputNumberResult]"