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:
For an OptionButton 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.
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 |