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

// Le champ Combo "COMBO_Civilité" affiche les titres de civilité :
// "Monsieur", "Madame" et "Mademoiselle".
// Un entier représentant une civilité sera retourné au langage.
ListAdd(COMBO_Civilité, "Monsieur" + gLink("1"))
// Seule la chaîne de caractères "1" est retournée au langage.
// Cette chaîne de caractères retournée n'est pas affichée dans le champ Combo.
// Autoriser la récupération de la valeur définie par la fonction gLien.
gLinkActivate(COMBO_Civilité, 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