StoredValue (Property)

a row in a List Box, ListView or Combo Box control.
a "Text token" Edit control.
a row of a Table control.
New in version 28
an row of the entry assisted by an edit control (if the row is selected).

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.
for "Text token" Edit controls: the value of the token.
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 an row from an Table control on variable, fed by an array of structures, to an array structure .
New in version 28
for an row assisted by an edit control: the stored value associated with the row. This value was defined either when adding the row (function AssistedInputAdd), or with an 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

New in version 28

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

// Evénement "Sélection d'une valeur dans la liste de saisie assistée"
// ----------------------------------------------------
PROCÉDURE 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>: entier

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

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:

<Valeur du Jeton 1> + RC + ... + <Valeur du Jeton N>

<Edit control>: Control name

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

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>: entier

Index of the row whose value is requested.

New in version 28

To know the stored value of an assisted entry row Hide the details

<Valeur mémorisée> = <Elément>.storedvalue

<Stored value>: Character string

Stored value for the row.

<Element>: Variable of type SasisieAssisted or Name of control

Variable of type AssistedInput containing the characteristics of the selected row.
Used in the event "Selection of a value in the assisted input list", this Variable contains the characteristics of the selected row.
Name of the edit control in which the row has been selected.

Remarks

Limits

The StoredValue property applies only to:

List Box, ListView and Combo Box controls.
"Text token" Edit controls.
New in version 28
to input fields offering assisted input.
the Table controls.

The StoredValue property applies only to:

to the fields List and Combo Box.
New in version 28
to input fields offering assisted input.

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:

List Box controls.
New in version 28
to input fields offering assisted input.