StoredValue (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls

Limitations

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

StoredValue (Property)

In french: ValeurMémorisée

The StoredValue property is used to get the value currently stored by:

a row in a List Box, ListView or Combo Box control.
a "Text token" Edit control.
a row of a Table control.
an input suggestion in an Edit control (if the suggestion is selected).

The currently stored value can correspond to:

for List, ListView control and File Combo fields to the value of the memorized item defined in the window editor ("Contents" tab of the field description):
.
for List, Image List and Combo Box control fields by programming to the value defined in programming by function gStoredValue.
Reminder: To activate the retrieval of the value defined by function gStoredValue:
- use the gStoredValueEnable function.
- check "Return value specified with gStoredValue" ("Details" tab of the control description).
Note This property can be used, for example, to retrieve stored values from a multi-selection List Box control.
for "Text tokens" type Edit control fields token value.
for a line in a table populated programmatically to the stored value of the line. For this type of control, you can also assign the stored value of the row.
for a row of a Table control based on a variable, populated by an array of structures: a structure of the array.
for a line with an Edit control: the stored value associated with the line. This value is defined when the suggestion is added with the AssistedInputAdd function, or with a variable of type AssistedInput.

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

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

// 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

AssistedInputAdd(EDT_Edit1, "Displayed value", "Stored value")

// "Select a value in the list of input suggestions" event
// ----------------------------------------------------
PROCEDURE Selection(MySelection is AssistedInput)
Trace(MySelection.StoredValue) 
// Returns "stored value"

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 you want to get.

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:
<Token Value 1> + CR + ... + <Token Value N>

<Edit control>: Control name

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

Not available in browser code

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 you want to get.

Not available in browser code

Getting the stored value of an input suggestion Hide the details

<Stored value> = <Element>.StoredValue

<Stored value>: Character string

Stored value for the row.

<Element>: AssistedInput variable or control name

AssistedInput variable containing the characteristics of the selected row.
When used in the "Select a value in the list of input suggestions" event, this variable contains the characteristics of the selected suggestion.
Name of the Edit control in which the row was selected.

Remarks

Limitations

The StoredValue property applies only to:

List Box, ListView and Combo Box controls.
"Text token" Edit controls.
Edit controls with input suggestions.
the Table controls.

The StoredValue property applies only to:

List Box and Combo Box controls.
Edit controls with input suggestions.

The StoredValue property can only be used with 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 can only be used with the following elements:

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

The StoredValue property applies only to:

List Box controls.
Edit controls with input suggestions.