Share via

Value Property

  • Article

Specifies the current state of a control. Available at design time and run time.

[Form.]Control.Value [= nSetting]

Return Value

  • nSetting
    Specifies a setting that indicates the current state of the control.

    For CommandGroup, ComboBox, EditBox, ListBox, OptionGroup, and Spinner controls, the Value property contains the character string or numeric value that is currently selected in the control.

    For a TextBox control, the Value property contains the character string or numeric, date, datetime, currency, or logical value that is currently selected in the control. The default value is a character string.

    For a CheckBox control, the following table lists the settings for nSetting:

    nSetting

    Description

    0

    Cleared. (Default)

    1

    Selected.

    2

    Mixed-value. This setting is only available in code.

    For an OptionButton control, the following table lists the settings for nSetting:

    nSetting

    Description

    0

    Not selected. (Default)

    1

    Selected.

Remarks

Applies To: CheckBox | ComboBox | CommandGroup | EditBox | Grid | ListBox | OptionButton | OptionGroup | Spinner | TextBox

For the Grid control, the Value property is available only when the Grid control has focus.

The Value method does not support the Assign method.

You can use the Value property of a CommandGroup or OptionGroup control to determine which button in the group triggers an event. The Value property is set to an integer that indicates which button in the group caused the event.

The Value property changes behavior when a control source is set for a control. When a control source is set, the Value property setting of a control is the data type of the variable or field referenced by the ControlSource property. If the data type is not valid for the given control, Visual FoxPro generates an error.

The following table lists valid data types.

Control

Data Types allowed

CheckBox

Integer, Logical, Numeric

ComboBox

Character, Integer, Numeric

CommandGroup

Character, Integer, Numeric

EditBox

Character, Memo

Grid

Character, Numeric

ListBox

Character, Integer, Numeric

OptionButton

Integer, Logical, Numeric

OptionGroup

Character, Integer, Numeric

Spinner

Currency, Integer, Numeric

TextBox

Any data type

See Also

Reference

Bound Property

ListIndex Property (Visual FoxPro)

Other Resources

Properties (Visual FoxPro)

Language Reference (Visual FoxPro)