Specifies the value stored in a component.
Declaration
| Read-Write Property | Variant |
| componentObj | One of the user forms components listed in the Applies To section |
Applies To
The property applies to the following components:
TcxCalcEdit, TcxCurrencyEdit, TcxDateEdit, TcxTimeEdit
Description
The EditValue property specifies the value stored in a component. Components provide other properties that let you work with a component’s value and actually they are wrappers for EditValue, but in some cases, it is necessary to use EditValue.
EditValue can store data of different types, including Null values. To determine the data type, expand the EditValue property in the User Forms editor and explore the Type subproperty. If EditValue stores Null, this means that a value is not stored in the component.
In most cases, the value displayed in the component is stored to the EditValue property when the user moves the input focus to another component or performs actions specific for the component, for example, closes the dropdown window. Additionally, if the Properties.ValidateOnEnter property is True, the displayed value is validated and stored to the component when the user presses the Enter key, if the form does not have a default button).
TcxCalcEdit.EditValue
The TcxCalcEdit component can store values of the Double type or the Null value. If EditValue stores Null, the Value property returns 0.
TcxCurrencyEdit.EditValue
The TcxCurrencyEdit component stores numeric values as well as the Null value. If EditValue stores Null, the Value property returns 0.
TcxDateEdit.EditValue
The TcxDateEdit component can store values of the TDateTime type as well as the Null value. If EditValue is Null, the Date property returns -70000 (the “null date”).
TcxTimeEdit.EditValue
The TcxTimeEdit component stores values of the TDateTime type and cannot store the Null value. The EditValue property holds both the date and time portions of the components’s value whereas Time lets you work with the time portion only.
Property Value
The value stored in the component.
Remarks
At run time, the value inputted by the user is only stored to the EditValue property moves the input focus to another component or performs actions specific for a component (for example, closes the dropdown window). Additionally, if the Properties.ValidateOnEnter property is True, the inputted value is validated and stored to the component when the user presses the Enter key (if the form has no default button).
As the user modifies the component’s value, it is not stored to the EditValue property until the specified actions take place.
See Also
Date Property
Time Property
Value Property
ValidateOnEnter Property