ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Graphic string functions
  • Distinct elements
  • Combo Box column
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
gToRetrieve (Function)
In french: gARécupérer
Warning
From version 27, gARetrieve is kept for backward compatibility. This function is replaced by gToRetrieve.
Describes the text value to display and to return when retrieving the value of an element found in a List Box control or in a Combo Box control.
Example
ListDeleteAll(LIST_Ad)
ListAdd(LIST_Ad, gPen(Black) + "Car")
// LIST_Ad[1] returns the character string "Car"
ListAdd(LIST_Ad, gToRetrieve("Boat") + gPen(Black) + " for sale")
// LIST_Ad[2] returns the character string "Boat"
ListAdd(LIST_Ad, gToRetrieve(gImage(2, 25) + "ABC") + "DEF")
// LIST_Ad[3] returns the character string "2,25" + ESC + "ABC"
// gRectangle, gCircle and gLine are ignored
ListAdd(LIST_Ad, gToRetrieve(gRectangle(0, 0, 50, 18)))
// LIST_Ad[4] returns an empty string
Syntax
<Result> = gToRetrieve(<String to return>)
<Result>: Character string
Control string that must be used in ListAdd, ListInsert or ListModify. Each returned element is separated by the ESC constant.
<String to return>: Character string
Text value to return. Only this parameter will be returned to the language. This parameter will be displayed in the row.
This parameter can contain functions for drawing in the list boxes (starting with the letter "g"). You can:
  • add drawings to the text,
  • modify the text formatting (background color, text color, etc.).
The created drawings will also be returned to the language.
ListSeek can be used to perform a search in the content of <String to return>.
Remarks

Distinct elements

Are considered as being distinct elements:
  • two texts separated by gPen or gCoord,
  • a text and an image.
Each returned element is separated by the ESC constant.

Combo Box column

For Combo Box columns, the sort depends on the content of the combo box and not on its index. Therefore, for combo boxes in tables, the content of the combo box that will be used to sort elements must be described with gToRetrieve.
Component: wd300obj.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help