gLinkActivate (Function)

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 functions / Controls, pages and windows / Graphic string functions

Activation/Deactivation
ListSeek function
Combo Box controls bound to items

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

gLinkActivate (Function)

In french: gLienActive

Warning
From version 27, this function is kept for backward compatibility. It is recommended to use gStoredValueEnable.

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

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.
ListAdd(COMBO_Title, "Mister" + gLink("1"))
// Only the string "1" is returned to the language.
// This string is not displayed in the Combo Box control.
// Allow to retrieve the value defined by gLink.
gLinkActivate(COMBO_Civility, True)

Syntax

<Result> = gLinkActivate(<List Box or Combo Box control> [, <Active>])

<Result>: Boolean

Corresponds to the former management mode:
True if the value defined by gLink 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.

<Active>: Optional boolean

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

Remarks

Activation/Deactivation

If the values defined with gLink 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 gLink.
- If the COMBO_COMBO1 control is bound to an item:
  - FileToScreen selects the row whose value of gLink is the one of the bound item.
  - ScreenToFile assigns the value of gLink to the bound HFSQL item.
If the retrieval of the values defined by gLink 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 gLinkActivate()=True, ListSeek takes the values added by gLink into account.
If gLinkActivate()=False, ListSeek ignores the values added by gLink. The search is performed using the displayed value.

Combo Box controls bound to items

gLinkActivate can be used to manipulate Combo controls bound to data file items (this binding is defined in the "File-to-screen binding" step of the control creation wizard or in the "Binding" tab of the control description window.

Component: wd300dllexe.dll