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

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.

Remarks

Limitations

The StoredValue property applies only to:

List Box, ListView and Combo Box 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 applies only to:

List Box controls.
Edit controls with input suggestions.