| Name | Type | Default | Description |
|---|
| DecimalSeparator | string | "." | Specifies or retrieves the character used as the decimal separator when formatting or parsing numeric values. This determines how fractional numbers are represented, for example, using a period ('.') or a comma (',') between the integer and fractional parts. |
| Disabled | bool | false | Controls whether the SmartNumericTextBox component is active or inactive. When enabled, users can interact with and enter values in the numeric text box. When disabled, the component becomes read-only and user interaction is prevented. |
| DropDownAppendTo | object | N/A | Specifies the parent HTML element or container to which the Radix dropdown will be rendered or appended. This determines the dropdown's positioning context within the DOM and can affect its stacking, placement, and overflow behavior. |
| DropDownEnabled | bool | false | Controls whether a dropdown menu appears when the radix display button is clicked. If enabled, the dropdown presents selectable options for switching between different numeral systems: binary, octal, decimal, and hexadecimal. This allows users to easily change the numeral system used for number display or input. |
| EnableMouseWheelAction | bool | false | Controls whether users can increase or decrease the value in the SmartNumericTextBox component by scrolling the mouse wheel. When enabled, scrolling the wheel while the input is focused will increment or decrement the numeric value accordingly. When disabled, mouse wheel actions will have no effect on the value. |
| Hint | string | "" | Displays supplementary helper text below the element to provide users with additional information, guidance, or context related to the element's purpose or required input. |
| InputFormat | NumericTextBoxInputFormat | NumericTextBoxInputFormat.Integer | Specifies or retrieves the input format used by the widget. Modifying this property at runtime may result in a loss of precision, as existing data could be reformatted or truncated to fit the new format. It is recommended to set the input format during initialization to preserve data accuracy. |
| Label | string | "" | Displays a descriptive text label above the element to provide context or identify its purpose for users. |
| LeadingZeros | bool | false | When this property is enabled, the binary and hexadecimal representations of a number are automatically padded with leading zeros as needed to ensure their length matches the specified wordLength. This guarantees consistent output width, even for numbers whose standard representations would be shorter than wordLength. |
| UnlockKey | string | "" | Sets or retrieves the unlockKey used to activate and access the product’s full features. When provided, the unlockKey grants authorization to unlock the product; when requested, it returns the current unlock key in use. |
| Locale | string | "en" | Sets or retrieves the current language code (e.g., 'en', 'fr', 'es'). This property determines which language is used for displaying localized content. It works together with the messages property, which should contain translations for each supported language. When the language is changed, the corresponding messages from the messages object are used for all localized text. |
| Max | object | N/A | Sets or retrieves the maximum allowable value for the widget. This defines the highest value that the widget can accept or display. |
| Messages | object | N/A | Defines or retrieves an object containing customizable text strings used within the widget, enabling localization of UI elements such as labels, messages, and tooltips. This property works together with the locale setting to display the widget's interface in different languages according to the user's preferences. |
| Min | object | N/A | Defines or retrieves the lowest allowable value that the widget can accept. This property determines the minimum limit for user input or programmatically set values. |
| Name | string | "" | Specifies the unique name assigned to the control element, which can be used to identify and reference the control within forms, scripts, or styles. This name is often utilized when processing form data or targeting the control with JavaScript or CSS. |
| Nullable | bool | false | Determines whether the value property can be set to null or an empty string. When enabled, assigning null or "" to the value property is allowed; otherwise, such assignments are prevented or ignored. Use this setting to control how empty or unset values are handled. |
| IsOpened | bool | false | Controls whether the radix dropdown menu is open or closed. This property can be set to open or close the dropdown programmatically, or read to determine its current state. It is effective only when dropDownEnabled is set to true; otherwise, the dropdown cannot be opened regardless of this property's value. |
| OutputFormatString | string | "null" | Defines or retrieves the display format pattern used to present the input value when the element is not in focus. The specified pattern determines how the value appears to the user (for example, adding commas, decimal places, or currency symbols) while not editing. You can apply any formatting string supported by the NumberRenderer class as the outputFormatString, allowing for customized number formats such as '0,0.00' for thousands separators and two decimal places. |
| Placeholder | string | "" | Specifies the placeholder text that appears within the widget's input field when no value has been entered. This text provides a hint or example to guide the user on what kind of input is expected. |
| PrecisionDigits | int | N/A | Specifies the number of digits to display after the decimal point in numeric values. This setting is only applicable when inputFormat is set to either 'floatingPoint' or 'complex', ensuring precise control over decimal precision for these input types. |
| Radix | NumericTextBoxRadix | NumericTextBoxRadix.10 | Sets or retrieves the radix (base) used by the SmartNumericTextBox for displaying its value. The radix determines the numeral system (such as decimal, binary, octal, or hexadecimal) in which the numeric value is shown. This property is only applicable when the inputFormat is set to 'integer', allowing the widget to represent integers in different numeral systems based on the specified radix value. |
| RadixDisplay | bool | false | Controls the visibility of the radix (base) selection button in the SmartNumericTextBox component. This option is relevant only when the inputFormat property is set to 'integer'. When enabled, users can toggle between different numeric bases (e.g., decimal, hexadecimal). When disabled, the radix selection button is hidden. |
| RadixDisplayPosition | NumericTextBoxDisplayPosition | NumericTextBoxDisplayPosition.Left | Gets or sets the position of the radix (decimal separator) display button in the SmartNumericTextBox component. This property determines where the button for selecting a radix is shown within the numeric input field (e.g., to the left or right of the input box). |
| Readonly | bool | false | Controls whether the SmartNumericTextBox is in a read-only state. When set to true, the user cannot modify the value; when set to false, the input can be edited. This property can be used to retrieve the current read-only status or to update it programmatically. |
| RightToLeft | bool | false | Sets or retrieves a value that determines whether the element's alignment supports right-to-left (RTL) text direction, such as for languages like Arabic or Hebrew. When enabled, the element will display its content aligned appropriately for RTL locales. |
| ScientificNotation | bool | false | Controls whether the output value is displayed using scientific notation (e.g., 1e+6 instead of 1000000). This option is only relevant when the inputFormat property is set to 'integer'. If enabled, large or small integer values will be formatted in scientific notation; if disabled, values will be displayed in standard numeric form. |
| ShowDropDownValues | bool | false | Controls whether the dropdown displays the current value simultaneously in all four numeral systems (binary, octal, decimal, and hexadecimal). If enabled, users will see the value represented in each numeral system option within the dropdown list. |
| ShowUnit | bool | false | Controls whether units are displayed or hidden in the user interface. When enabled, units will be visible; when disabled, units will be concealed from view. |
| SignificantDigits | int | 8 | Calculates the number of significant digits present in a given number. This operation is only valid when the inputFormat is set to either 'floatingPoint' or 'complex', ensuring that the input is a numerical value represented as a floating-point or complex number. Use this functionality to assess numerical precision and significance within these specific formats. |
| SpinButtons | bool | false | Controls whether the spin buttons (increment and decrement controls) are displayed or hidden in the input field. When enabled, users can adjust the value using these buttons; when disabled, the spin buttons are not visible. |
| SpinButtonsDelay | int | 75 | Specifies the amount of time, in milliseconds, to wait between consecutive activations of the spin buttons when a user holds down the control. This determines how quickly the value will increment or decrement while the button is continuously pressed. |
| SpinButtonsInitialDelay | int | 0 | Specifies the amount of time, in milliseconds, to wait before starting the first repeated action when a spin button is held down. This initial delay determines how long the user must press and hold the button before automatic repeating begins. |
| SpinButtonsPosition | NumericTextBoxDisplayPosition | NumericTextBoxDisplayPosition.Right | Specifies or retrieves the location of the spin buttons (increment and decrement controls) on the SmartNumericTextBox component. This property allows you to control whether the spin buttons appear on the left, right, or another designated position within the input field. |
| SpinButtonsStep | object | 1 | Specifies or retrieves the increment or decrement value used when adjusting the control. This value determines by how much the value increases or decreases with each step (such as when using up/down arrows or stepper buttons). |
| Theme | string | "" | Specifies the theme to be applied to the element. The selected theme controls the overall appearance, including colors, fonts, and styling, ensuring a consistent visual design across the interface. |
| Unfocusable | bool | false | When set to true, this property prevents the element from receiving keyboard focus, meaning users cannot navigate to the element using the Tab key or other focus methods. |
| Unit | string | "kg" | Gets or sets the name of the unit (such as "kg", "cm", "$", etc.) displayed in the SmartNumericTextBox widget. This property allows you to specify the unit label that appears alongside the numeric input, providing context for the entered value. |
| Validation | Validation | Validation.Strict | Enhances value validation using the specified minimum and maximum constraints.
- When set to 'strict', the value is continuously validated: any value outside the defined min or max boundaries is automatically corrected to the nearest valid value, regardless of how the value is updated (user interaction or programmatically).
- When set to 'interaction', validation only occurs through user interactions such as typing or dragging. Programmatic changes to the value are not coerced within the min or max range. Additionally, if the min or max limits are updated, and the current value falls outside the new range, it remains unchanged and no change event is triggered. |
| Value | string | "0" | Sets or retrieves the current numeric value of the SmartNumericTextBox widget. When used as a setter, it updates the widget's displayed value to the specified number. When used as a getter, it returns the widget’s current numeric value. This function supports both setting and getting the value, depending on whether a parameter is provided. |
| WordLength | WordLength | WordLength.Int32 | Specifies or retrieves the word length when the inputFormat is set to 'integer'. This property is only relevant for integer inputs. If the min and/or max values are not explicitly defined, they will be automatically calculated based on the given word length—ensuring that the valid input range matches the specified number of bits. |
| Name | Type | Description | Event Detail |
|---|
| OnChange | EventCallback<Event> | This event is triggered whenever the value changes, whether due to user input or programmatic updates. It allows you to respond in real time when the value is modified. | N/A |
| Changed | event NumericTextBoxChangedEventHandler | This event is triggered whenever the value changes, whether due to user input or programmatic updates. It allows you to respond in real time when the value is modified. | NumericTextBoxChangedEventArgs |
| OnChanging | EventCallback<Event> | This event is triggered whenever the input value is modified by the user through actions such as typing on the keyboard or pasting text into the field. It detects changes in real-time as they occur, allowing you to respond immediately to user input. | N/A |
| Changing | event NumericTextBoxChangingEventHandler | This event is triggered whenever the input value is modified by the user through actions such as typing on the keyboard or pasting text into the field. It detects changes in real-time as they occur, allowing you to respond immediately to user input. | NumericTextBoxChangingEventArgs |
| OnClose | EventCallback<Event> | This event is triggered immediately after the dropdown menu has been closed by the user, either through selecting an option, clicking outside the dropdown, or using a keyboard action. Use this event to execute any actions or cleanup that should occur once the dropdown is no longer visible. | N/A |
| Closed | event NumericTextBoxClosedEventHandler | This event is triggered immediately after the dropdown menu has been closed by the user, either through selecting an option, clicking outside the dropdown, or using a keyboard action. Use this event to execute any actions or cleanup that should occur once the dropdown is no longer visible. | NumericTextBoxClosedEventArgs |
| OnClosing | EventCallback<Event> | This event is fired just before the dropdown menu is closed, giving you an opportunity to execute custom logic or prevent the closure. If you wish to stop the dropdown from closing, you can call event.preventDefault() within your event handler. This allows for conditional closing behavior based on your application's requirements. | N/A |
| Closing | event NumericTextBoxClosingEventHandler | This event is fired just before the dropdown menu is closed, giving you an opportunity to execute custom logic or prevent the closure. If you wish to stop the dropdown from closing, you can call event.preventDefault() within your event handler. This allows for conditional closing behavior based on your application's requirements. | NumericTextBoxClosingEventArgs |
| OnOpen | EventCallback<Event> | This event is triggered whenever the dropdown menu becomes visible to the user, such as when the user clicks on the dropdown control or focuses on it using the keyboard. | N/A |
| Opened | event NumericTextBoxOpenedEventHandler | This event is triggered whenever the dropdown menu becomes visible to the user, such as when the user clicks on the dropdown control or focuses on it using the keyboard. | NumericTextBoxOpenedEventArgs |
| OnOpening | EventCallback<Event> | This event is fired just before the dropdown menu begins to open. If you need to prevent the dropdown from opening—for example, based on certain conditions—you can call event.preventDefault() within your event handler function. Doing so cancels the opening operation, allowing you to control when or whether the dropdown appears. | N/A |
| Opening | event NumericTextBoxOpeningEventHandler | This event is fired just before the dropdown menu begins to open. If you need to prevent the dropdown from opening—for example, based on certain conditions—you can call event.preventDefault() within your event handler function. Doing so cancels the opening operation, allowing you to control when or whether the dropdown appears. | NumericTextBoxOpeningEventArgs |
| OnRadixChange | EventCallback<Event> | This event is triggered whenever the radix value is modified by the user. It notifies listeners that the numerical base (such as decimal, binary, or hexadecimal) used for number input or display has been changed, allowing your application to update related components or recalculate values as necessary. | N/A |
| RadixChanged | event NumericTextBoxRadixChangedEventHandler | This event is triggered whenever the radix value is modified by the user. It notifies listeners that the numerical base (such as decimal, binary, or hexadecimal) used for number input or display has been changed, allowing your application to update related components or recalculate values as necessary. | NumericTextBoxRadixChangedEventArgs |