- Distinct elements
- Combo Box column
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.
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 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.
This page is also available for…
|
|
|
|