4D v14.3

LISTBOX SET TABLE SOURCE

Home

 
4D v14.3
LISTBOX SET TABLE SOURCE

LISTBOX SET TABLE SOURCE 


 

LISTBOX SET TABLE SOURCE ( {* ;} object ; tableNum | name {; highlightName} )  
Parameter Type   Description
Operator in If specified, object is an object name (string) If omitted, object is a variable
object  Form object in Object name (if * is specified) or Variable (if * is omitted)
tableNum | name  Longint, String in Number of table whose current selection is to be used or Named selection to be used
highlightName  String in Name of highlight set

The LISTBOX SET TABLE SOURCE command can be used to modify the source of the data displayed in the listbox that is designated by the * and object parameters.

Note: This command can only be used when the “Data Source” property of the list box is set to Current Selection or Named Selection (for more information about this, please refer to the Managing List Box Objects section). It does nothing if you use it with a listbox that is associated with an array.

If you pass the optional * parameter, you indicate that the object parameter is an object name (string). If you do not pass this parameter, you indicate that the object parameter is a variable. In this case, you pass a variable reference instead of a string. For more information about object names, please refer to the Object Properties section.

If you pass a table number as the tableNum parameter, the listbox will be filled in with the data of the records in the current selection of the table.

If you pass a named selection as the name parameter, the listbox will be filled in with the data of the records belonging to the named selection.

The optional highlightName parameter associates a highlight set with the list box. The highlight set manages record highlighting by the user in the list box.

If the listbox already contains columns, their contents will be updated after the command is executed.

Note: For optimization purposes, this command is processed in an asynchronous manner; in other words, the source of the listbox is changed only after the complete execution of the method in which the command is called.

 
PROPERTIES 

Product: 4D
Theme: List Box
Number: 1013

 
HISTORY 

Created: 4D v11 SQL
Renamed: 4D v12
Modified: 4D v13

 
SEE ALSO 

LISTBOX GET TABLE SOURCE

 
ARTICLE USAGE

4D Language Reference ( 4D v14 R3)
4D Language Reference ( 4D v14 R2)
4D Language Reference ( 4D v13.5)
4D Language Reference ( 4D v14.3)
4D Language Reference ( 4D v14 R4)

Inherited from : LISTBOX SET TABLE SOURCE ( 4D v12.4)