gStoredValueEnable (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Controls, pages and windows / Graphic string functions

Activation/Deactivation
ListSeek function
Auto-filled combo boxes

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

gStoredValueEnable (Function)

In french: gValeurMémoriséeActive

Allows (or not) to retrieve the value defined by gStoredValue in a List Box control or in a Combo Box control.

Note: This function is equivalent to gLinkActivate.

Example

// The Combo Box control "COMBO_Title" displays the titles:
// "Mister", "Madam" and "Miss".
// An integer representing a gender will be returned to the language.
ListeAdd(COMBO_Title, "Mister" + gStoredValue("1"))
// Only the string "1" is returned to the language.
// This string is not displayed in the Combo Box control.
// Allow retrieving the value defined with gStoredValue.
gStoredValueEnable(COMBO_Title, True)

Syntax

<Result> = gStoredValueEnable(<List Box or Combo Box control> [, <Enabled>])

<Result>: Boolean

Corresponds to the former management mode:
True if the value defined by gStoredValue was retrieved (default value),
False otherwise.

<List Box or Combo Box control>: Control name

Name of the List Box or Combo Box control to be used.

<Enabled>: Optional boolean

True if the value defined by gStoredValue must be retrieved (default value),
False otherwise.

Remarks

Activation/Deactivation

If the values defined with gStoredValue are retrieved from the COMBO_COMBO1 control (<Active> = True):
COMBO_COMBO1.Value returns the order number in the COMBO_COMBO1 control.
COMBO_COMBO1[COMBO_COMBO1] returns the value of gStoredValue.
- If the COMBO_COMBO1 control is bound to an item:
  - FileToScreen selects the row whose value of gStoredValue is the one of the bound item.
  - ScreenToFile assigns the value of gStoredValue to the bound HFSQL item.
If the retrieval of the values defined by gStoredValue is disabled on the COMBO_COMBO1 control (<Active> = False):
COMBO_COMBO1.Value returns the order number in the COMBO_COMBO1 control.
COMBO_COMBO1[COMBO_COMBO1] returns the current displayed value.
- If the COMBO_COMBO1 control is bound to an item:
  - FileToScreen selects the row whose rank is equal to the bound item.
  - ScreenToFile assigns the number of the selected element to the bound HFSQL item, i.e., ListSelect(COMBO_COMBO1).

ListSeek function

If gStoredValueEnable()=True, ListSeek takes the values added by gStoredValue into account. The search is performed using the stored value.
If gStoredValueEnable()=False, ListSeek ignores the values added by gStoredValue. The search is performed using the displayed value.

Auto-filled combo boxes

gStoredValueEnable is used to manage "Auto-filled Combo Box" controls.

Component: wd300obj.dll