gLink (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Location of gLink
Added value
Sensitivity to the case
Auto-filled combo boxes
Retrieved element
Scheduler control
Special case: Combo Box control or Combo Box in a Table control

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

gLink (Function)

In french: gLien

Adds an "invisible" value into an element found in a List Box, Combo Box or Scheduler control. This value will be the stored value when the control element is selected by the user.

Remarks:

To get the stored value associated with an element of the control, use the StoredValue property.
To retrieve the value defined by gLink:
- use gLinkActivate.
- check "Returns the value specified by gLink" ("Details" tab of control description).
In this case, the control will directly return the value of gLink corresponding to the selected option.

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

// Button control code to fill the Combo Box control
// ----------------------------------------------
// The "COMBO_Title" Combo Box displays personal 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 returned character string is not displayed in the combo box.

// Code of the Button control used to get the value of gLink
// -----------------------------------------------------------
// Code used to get the value of gLink for the selected option
Info(COMBO_Title[COMBO_Title].StoredValue)
// Displays "1" in our example.

Syntax

<Result> = gLink(<String to return>)

<Result>: Character string

Control string that must be used in ListAdd, ListInsert or ListModify.

<String to return>: Character string (with quotes)

Text value to return. Only this string will be returned to the language. This string will not be displayed in the row.

Remarks

Location of gLink

gLink can be called anywhere in the row to add.

For example:

ListAdd(COMBO_COMBO1, gLink("1") + "Mister")
// or
ListAdd(COMBO_COMBO1, "Mister" + gLink("1"))

Added value

When a value is added by gLink, this value is ignored by the sort and by the shortcuts.

If several values are added into an element of a list box by gLink, only the first value will be returned.

ListAdd(LIST_LIST1, "MyElement" + gLink("Link1") + gLink("Link2"))

In this example, only the "Link1" value will be returned.

ListSeek takes into account the values added by gLink.

Sensitivity to the case

gLink is not case sensitive (uppercase/lowercase characters).

Therefore, the following code:

ListAdd(LIST_LIST1, "MyElement" + gLink("AAA"))

will be equivalent to:

ListAdd(LIST_LIST1, "MyElement" + gLink("aaa"))

Auto-filled combo boxes

gLink is used to manage the "auto-filled combo box" controls.

Retrieved element

When an element is retrieved from a List Box or Combo Box control, the priority order is as follows:

Values added by gLink.
Values added by gARetrieve.

To get the stored value associated with an element of the control, use the StoredValue property.

Scheduler control

If the resources in the schedule have been created with SchedulerAddResource using gLink, the name of the resource obtained with the SelectedResource property will correspond to the value specified in the gLink function for this resource.

Example:

// Adds a resource (a meeting room) into the Scheduler control
// Meeting is the data file that describes the available meeting rooms
SchedulerAddResource(SCH_RoomOccupancy, Meeting.Name + gLink(Meeting.MeetingID))

...

// Click code on BTN_NEW_APT button
MyAPT is Appointment
IF SCH_RoomOccupancy.SelectedResource = "" THEN
RETURN
END

MyAPT.StartDate = SCH_RoomOccupancy.StartDate
MyAPT.EndDate = SCH_RoomOccupancy.EndDate
MyAPT.Resource = SCH_RoomOccupancy.SelectedResource
// The name of the resource corresponds to the value specified
// in gLink for this resource

Special case: Combo Box control or Combo Box in a Table control

If gLink must return an empty string (""), the result will be different if the control used is a Combo Box control or a Combo Box column in a Table control.

The following code is used:

ListAdd(COMBO, "MyElement" + gLink(""))

the value retrieved will be:

an empty string ("") in the case of a Combo Box control,
0 (zero) in the case of a Combo Box column in a Table control.

To keep the same code for retrieving the value of gLink for a Combo Box control and a Combo Box column, it is recommended to use a Combo Box control in a container column of the Table control.

Component: wd260obj.dll