Version 1.0.1 adds two-way variable binding. A variable assigned in the properties panel initializes the control when it contains a valid time, and user changes are written back automatically.
1. Overview & Purpose
The neoTimeInput plugin provides a modern 12/24-hour time entry input field with spinner arrows, optional seconds display (showSeconds), time range validation (minTime, maxTime), and keyboard focus controls.
2. Custom Control Properties
Control: neoTimeInput (neo-time-input)
| Property Name | Type | Default Value | Description |
|---|---|---|---|
| variable | variable | "" | Optional VisualNEO variable (e.g. [MyTime]) bound directly to the time value. |
value | string | "12:00" | Initial selected time (HH:mm or HH:mm:ss). |
minTime | string | "00:00:00" | Minimum allowable time bound. |
maxTime | string | "23:59:59" | Maximum allowable time bound. |
showSeconds | boolean | false | Enables or disables seconds entry segment. |
use24Hour | boolean | true | Uses 24-hour time format (true) or 12-hour AM/PM format (false). |
3. Actions & Commands Reference
neoTimeInputSetValue
Sets the active time value of a neoTimeInput control.
- Command Syntax:
neoTimeInputSetValue "ObjectName" "TimeStr" - Parameters:
- •
ObjectName(string): Target control name. - •
TimeStr(string): Time string (e.g."14:30"or"09:15:30").
neoTimeInputGetValue
Retrieves current time string into [neoTimeInputResult] (and optionally into a specified variable).
- Command Syntax:
neoTimeInputGetValue "ObjectName" "[ResultVar]" - Parameters:
- •
ObjectName(string): Target control name. - •
ResultVar(string, optional): Variable to receive the time string (e.g."[UserTime]").
neoTimeInputSetRange
Configures allowable minimum and maximum time bounds.
- Command Syntax:
neoTimeInputSetRange "ObjectName" "MinTime" "MaxTime"
neoTimeInputSetFormat
Configures time display formatting (seconds visibility and 24-hour mode).
- Command Syntax:
neoTimeInputSetFormat "ObjectName" "ShowSeconds" "Use24Hour" - Alternative Format String Syntax:
neoTimeInputSetFormat "ObjectName" "Format"(e.g."HH:mm:ss","HH:mm","hh:mm:ss tt","hh:mm tt","24h","12h").
neoTimeInputFocus
Moves keyboard focus to the time input control.
- Command Syntax:
neoTimeInputFocus "ObjectName"
neoTimeInputClear
Resets time value to default minimum bound.
- Command Syntax:
neoTimeInputClear "ObjectName"
4. Events Reference
change: Triggered when the user edits or changes the time.commit: Triggered when a time entry is committed.invalid: Triggered when an entered time violates range constraints.
5. Practical Usage Example (VisualNEO Win Script)
. --- Configure 12-hour AM/PM schedule picker with seconds ---
neoTimeInputSetFormat "TimePicker1" "True" "False"
neoTimeInputSetValue "TimePicker1" "02:30:00"
. --- Retrieve selected time ---
neoTimeInputGetValue "TimePicker1"
SetVar "[SelectedTime]" "[neoTimeInputResult]"