ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls
  • Limitations
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
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 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):
    Stored value of a Combo Box control
    .
  • 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.
    • Universal Windows 10 AppAndroid 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 a row of a Table control based on a variable, populated by an array of structures: a structure of the array.
  • for an input suggestion in an Edit control: the stored value associated with the suggestion. 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
// ----------------------------------------------------
PROCÉDURE 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.
Android The StoredValue property applies only to:
  • List Box and Combo Box controls.
  • Edit controls with input suggestions.
iPhone/iPad The StoredValue property applies only to:
  • List Box controls.
  • Edit controls with input suggestions.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 12/05/2023

Send a report | Local help