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, List Box control and Combo fields linked to a data file for List, Image List and Combo fields linked to a data file: to the value of the stored 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 programmatically populated Table field 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 an Edit control assisted input line 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

// Valeurs sélectionnées dans un champ Liste multisélection
i is int = 1
iLigneSélectionnée is int
iLigneSélectionnée = ListSelect(LISTE_Cedex, 1)
WHILE iLigneSélectionnée <> -1
	Trace(LISTE_Cedex[iLigneSélectionnée].ValeurMémorisée)
	i++
	iLigneSélectionnée = ListSelect(LISTE_Cedex, i)
END

// Connaître la valeur mémorisée lors de la sélection du 3ème élément du champ Liste
Info("La valeur mémorisée est " + LISTE_Cedex[3].ValeurMémorisée)

// Connaître la valeur mémorisée par le champ de saisie de type "Jetons de texte"
Info("La valeur mémorisée est " + SAI_Jeton.ValeurMémorisée)
// Renvoie par exemple : 
// JETON_AJOUTÉ+RC+JETON_AJOUTÉ2

AssistedInputAdd(SAI_Saisie1, "Valeur affichée", "Valeur mémorisée")

// Evénement "Sélection d'une valeur dans la liste de saisie assistée"
// ----------------------------------------------------
PROCEDURE Sélection(MaSélection is AssistedInput)
Trace(MaSélection.ValeurMémorisée) 
// Renvoie "valeur mémorisée"

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.