EditValue Property

Applies to TestComplete 15.47, last modified on January 20, 2023

Specifies the value stored in a component.

Declaration

componentObj.EditValue
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

Highlight search results