Kinetic Control Compendium

hmwillett · August 29, 2023, 3:40pm

Numeric Box

Meant for numeric entry, numbers/decimals/currencies etc. Provides validations and checks.

Property Group	Property	Description
Basic	Id	Unique identifier for the control
Basic	Label Text	Sets the label within the control. (Fig. A)
Behavior	On Search Click	When the search checkbox is enabled, click this to create an event to control the search. This normally predefines everything, but this one gives you a nice, “undefined_onClick” event. How neat.
Behavior	On Blur	Click this to create an OnBlur event for the control. On Blur is triggered when the control loses focus.
Behavior	On Create	Click this to create an OnCreate event for the control On Create is triggered when the control is painted to the GUI.
Comments	Comments	Add some developer notes to the control. These are not customer-facing and are only visible in App Studio (Fig. B)
Data	Key Field	Indicates that a bound component is a key field. If true, the field is enabled if there is no current record, allowing the user to select an existing record or create a new one.
Data	EpBinding	Bind the button to a DataView.Column.
Layout	Alignment	Set the alignment for the control. Valid options are Left, Center, Right. (Fig. C)
Layout	Width	Sets the specific width (pixels) for the control. (Fig. D)
State	Personalizable	If true, a user can personalize this component(hide/show)
State	Customizable	If true, a user can customize this component in child layers
State	Hidden	Hides the control from view.
State	Disabled	Disables the control. The control will not allow editing or focus.
State	Read Only	Makes the control read only so that it will not allow editing. The control can still be focused.
State	Auto Focus	When enabled, the control is automatically focused on creation.
Advanced	Min	Minimum value for the control. If the user tries to enter a value less than the min, it will auto correct to a value above. For instance, if I set a min value of 100 and I enter 1 into the control, it will add two zeroes to be 100.
Advanced	Max	Maximum value for the control. If the user tries to enter a value greater than the max, it will auto correct to a value below. For instance, if I set a max value of 1000 and I enter 9999 into the control, it will correct to 1000.
Advanced	Step	Specify the increment/decrement value. Used in conjunction with the spinners property. (Fig. E)
Advanced > Format	Style	Doesn’t work.
Advanced > Format	Currency	Doesn’t work.
Advanced > Format	Currency Display	Doesn’t work.
Advanced > Format	Minimum Integer Digits	Doesn’t work.
Advanced > Format	Minimum Fraction Digits	Doesn’t work.
Advanced > Format	Maximum Fraction Digits	Doesn’t work.
Advanced > Format	Use Grouping	Doesn’t work.
Advanced	Spinners	Enable increment/decrement spinners on the control. (Fig. E)
Advanced	Auto Correct	Auto correct… to what??? 42?
Advanced	Disable Change Value On Scroll	Lol, scroll didn’t work in the first place.
Advanced	Mask	Works to an extent… It will allow you to use masks to define leading zeros, number of decimals, etc., but you cannot change the separator format (like change the comma to a decimal). And if you make a decimal masked like an integer, you get a fun, giant tilde for the precise value! (Fig. F)
Advanced	LabelText SearchDesc	Set the label text for the search description field. Requires “Enable Search” to be enabled. (Fig. G)
Advanced	Ep Binding SearchDesc	Set the data binding to store the description value from the search. Format: DataView.Column. Example: ABCCode.String1_c. Requires “Enable Search” to be enabled.
Advanced	Nullable	Allows the value to be null. (Fig. H)
Advanced	Enable Search	Shows the search button. (Fig. I)