version 11
SET LISTBOX TABLE SOURCE ({*; }object; tableNum | name)
Parameter | Type | Description | |
* | * | 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 | name | Longint |String | Number of table whose current selection | |
is to be used or Named selection to be used |
Description
The SET LISTBOX 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 Management of 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 do not pass a string but a variable reference. 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.
If the listbox already contains columns, their contents will be updated after the command is executed.
See Also