Allows (or not) to retrieve the value defined by
gLink in a List Box control or in a Combo Box control.
// 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
- 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:
- 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).
- 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: wd280dllexe.dll