LISTBOX GET TABLE SOURCE

Home

4D v16.3


LISTBOX GET TABLE SOURCE ( {* ;} object ; tableNum {; name {; highlightName}} )

Parameter	Type	Description
*	Operator	If specified, object is an object name (string) If omitted, object is a variable
object	Form object	Object name (if * is specified) or Variable (if * is omitted)
tableNum	Longint	Table number of selection
name	String	Name of named selection or "" for the current selection
highlightName	String	Name of highlight set

Description

The LISTBOX GET TABLE SOURCE command can be used to find out the current source of the data displayed in the list box that is designated by the * and object parameters.

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.

The command returns the number of the main table associated with the list box in the tableNum parameter and the name of any named selection used in the optional name parameter.

If the rows of the list box are linked with the current selection of the table, the name parameter, if passed, returns an empty string. If the rows of the list box are linked with a named selection, the name parameter returns the name of this named selection.

If the list box is associated with arrays, tableNum returns -1 and name, if passed, returns an empty string.