version 2004
INSERT LISTBOX ROW ({*; }object; position)
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) | |||
position | Longint | Position of the row to insert |
Description
The INSERT LISTBOX ROW command inserts a new row in the list box set in the object and * 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 do not pass a string, but a variable reference. For more information about object names, refer to the Object Properties section.
The row is inserted at the position set by the position parameter. A new row is automatically added at this position in all the arrays used by the list box columns, whatever their type and their visibility.
If the position value is higher than the total number of rows in the list box, the row is added at the end of each array. If it is equal to 0, the row is added at the beginning of each array. If it contains a negative value, the command does nothing.
See Also