INSERT LISTBOX ROW

4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next

version 2004


INSERT LISTBOX ROW ({*; }object; position)

ParameterTypeDescription
*If specified, object is an object name (string)
If omitted, object is a variable
objectForm objectObject name (if * is specified) or
Variable (if * is omitted)
positionLongintPosition 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

DELETE LISTBOX ROW.


4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next