StoredValue (Property)

a row in a List Box, ListView or Combo Box control.
Versions 24 and later
a "Text token" edit control.
New in version 24
a "Text token" edit control.
a "Text token" edit control.
Versions 27 and later
a row of a Table control.
New in version 27
a row of a Table control.
a row of a Table control.

The currently stored value can correspond to:

for List Box, ListView, and Combo Box controls based on a data file: the value of the stored item defined in the window editor ("Content" tab of the control description):
.
for List Box, ListView, and Combo Box controls populated programmatically: the value defined by gStoredValue.
Reminder: To retrieve the value defined by gStoredValue:
- use the gStoredValueEnable function.
- check "Return value specified with gStoredValue" ("Details" tab of the control description).
Remark: This property can be used to retrieve the stored values from a multi-selection List Box.
Versions 24 and later
for "Text token" edit controls: the value of the token.
New in version 24
for "Text token" edit controls: the value of the token.
for "Text token" edit controls: the value of the token.
Versions 27 and later
for a row of a Table control populated programmatically: the stored value of the row. For this type of control, you can also assign the stored value of the row.
New in version 27
for a row of a Table control populated programmatically: the stored value of the row. For this type of control, you can also assign the stored value of the row.
for a row of a Table control populated programmatically: the stored value of the row. For this type of control, you can also assign the stored value of the row.
Versions 27 and later
a structure of the array, for a row of a Table control based on a variable, populated by an array of structures.
New in version 27
a structure of the array, for a row of a Table control based on a variable, populated by an array of structures.
a structure of the array, for a row of a Table control based on a variable, populated by an array of structures.

Versions 16 and later

This property is now available for PHP sites.

New in version 16

This property is now available for PHP sites.

This property is now available for PHP sites.

Versions 15 and later

This property is now available for Android applications.

New in version 15

This property is now available for Android applications.

Versions 17 and later

This property is now available for iPhone/iPad applications.

New in version 17

This property is now available for iPhone/iPad applications.

Versions 21 and later

This property is now available in Universal Windows 10 App mode.

New in version 21

This property is now available in Universal Windows 10 App mode.

Example

// Values selected in a multi-selection List Box control
i is int = 1
iSelectedRow is int
iSelectedRow = ListSelect(LIST_Cedex, 1)
WHILE iSelectedRow <> -1
Trace(LIST_Cedex[iSelectedRow].StoredValue)
i++
iSelectedRow = ListSelect(LIST_Cedex, i)
END

// Find out the stored value when selecting the 3rd element of the List Box control
Info("The stored value is " + LIST_Cedex[3].StoredValue)

Versions 24 and later

// Find out the value stored by the "Text token" edit control
Info("The stored value is " + EDT_Token.StoredValue)
// Returns for example:
// TOKEN_ADDED+CR+TOKEN_ADDED2

New in version 24

// Find out the value stored by the "Text token" edit control
Info("The stored value is " + EDT_Token.StoredValue)
// Returns for example:
// TOKEN_ADDED+CR+TOKEN_ADDED2

Syntax

Getting the stored value of a List Box, ListView or Combo Box control Hide the details

<Stored value> = <Control used>[<Element index>].StoredValue

<Stored value>: Character string

Value that will be stored if the user selects the element in the specified control.

<Control used>: Control name

Name of the List Box, ListView or Combo Box control to use.

<Element index>: Integer

Index of the element in the control (List Box, ListView or Combo Box) whose stored value is requested.

Versions 24 and later

Getting the value stored in a "Text token" edit control Hide the details

<Stored value> = <Edit control>.StoredValue

<Stored value>: Character string

Stored value. If the control has several tokens, this parameter will have the following syntax:

<Value of Token 1> + CR + ... + <Value of Token N>

<Edit control>: Control name

Name of the "Text token" edit control to use.

New in version 24

Getting the value stored in a "Text token" edit control Hide the details

<Stored value> = <Edit control>.StoredValue

<Stored value>: Character string

Stored value. If the control has several tokens, this parameter will have the following syntax:

<Value of Token 1> + CR + ... + <Value of Token N>

<Edit control>: Control name

Name of the "Text token" edit control to use.

Getting the value stored in a "Text token" edit control Hide the details

<Stored value> = <Edit control>.StoredValue

<Stored value>: Character string

Stored value. If the control has several tokens, this parameter will have the following syntax:

<Value of Token 1> + CR + ... + <Value of Token N>

<Edit control>: Control name

Name of the "Text token" edit control to use.

Versions 27 and later

Getting the stored value of a row of a Table control Hide the details

<Stored value> = <Table control>[<Row index>].StoredValue

<Stored value>: Character string

Stored value for the row.

<Table control>: Control name

Name of the Table control to be used.

<Row index>: Integer

Index of the row whose value is requested.

New in version 27

Getting the stored value of a row of a Table control Hide the details

<Stored value> = <Table control>[<Row index>].StoredValue

<Stored value>: Character string

Stored value for the row.

<Table control>: Control name

Name of the Table control to be used.

<Row index>: Integer

Index of the row whose value is requested.

Getting the stored value of a row of a Table control Hide the details

<Stored value> = <Table control>[<Row index>].StoredValue

<Stored value>: Character string

Stored value for the row.

<Table control>: Control name

Name of the Table control to be used.

<Row index>: Integer

Index of the row whose value is requested.

Remarks

Limitations

The StoredValue property applies only to:

List Box, ListView and Combo Box controls.
Versions 24 and later
"Text token" edit controls.
New in version 24
"Text token" edit controls.
"Text token" edit controls.
Versions 27 and later
the Table controls.
New in version 27
the Table controls.
the Table controls.

The StoredValue property applies only to List Box and Combo Box controls.

Versions 16 and later

The StoredValue property applies only to the following elements:

Combo Box controls and rows of Combo Box controls.
ListView controls and rows of ListView controls.
Group of controls.

New in version 16

The StoredValue property applies only to the following elements:

Combo Box controls and rows of Combo Box controls.
ListView controls and rows of ListView controls.
Group of controls.

The StoredValue property applies only to the following elements:

Combo Box controls and rows of Combo Box controls.
ListView controls and rows of ListView controls.
Group of controls.

Versions 17 and later

The StoredValue property applies only to List Box controls.

New in version 17

The StoredValue property applies only to List Box controls.