State property
Returns or sets a value that indicates the visual state of the input field at runtime. Read/write. Constant.
At design time, the state of this property is always gfxInputFieldStateInput. Attempts to change it result in an error that indicates that this property can only be set at runtime.
If the field is not configured as Continuously Update, attempts to change the state to
update
(gfxInputFieldStateUpdate) fail and an error is raised with Err.Number equal to gfxErrorInvalidPropValue.When the state is changed to update, any value in the field is lost and no warning or error is produced.
Syntax
object
.State
[ = state
]where
object
– is the name of a NumericInput or StringInput object or an expression that evaluates to a NumericInput or StringInput object.state
– is a constant of the type gfxInputFieldStateConstants that specifies the state of the input field.Remarks
- When the state is changed to gfxInputFieldStateInput, input focus is not moved to the field. Use the SetFocus or SetElementFocus method to move input focus to the field.
- When input focus is set to the input field, the field is put into the input state (gfxInputFieldStateInput).
Provide Feedback