gLinkActivate (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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.

Versions 15 and later

This function is now available for Android applications.

New in version 15

This function is now available for Android applications.

Versions 16 and later

This function is now available for PHP sites.

This function is now available for WINDEV applications in Linux.

New in version 16

This function is now available for PHP sites.

This function is now available for WINDEV applications in Linux.

This function is now available for PHP sites.

This function is now available for WINDEV applications in Linux.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available in Android widget mode.

New in version 18

This function is now available in Android widget mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

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 retrieving the value defined by gLink.
gLinkActivate(COMBO_Title, 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 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 on the displayed value.

Combo Box controls bound to items

gLinkActivate can be used to handle 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: wd270dllexe.dll