4D v13.4

LISTBOX INSERT ROWS

Home

 
4D v13.4
LISTBOX INSERT ROWS

LISTBOX INSERT ROWS 


 

LISTBOX INSERT ROWS ( {* ;} object ; vPosition {; numRows} )  
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)
vPosition  Longint in Position of the row to insert
numRows  Longint in Number of rows to insert

The LISTBOX INSERT ROWS command inserts one or several new row(s) in the list box set in the object and * parameters.

Note: This command only works with list boxes based on arrays. When this command is used with a list box based on a selection, it does nothing and the OK system variable is set to 0.

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, refer to the Object Properties section.

By default, if numRows is omitted, only one row is inserted. Otherwise, the command inserts the number of rows defined in this parameter.

This command inserts the row(s) at the position set by the position parameter and these row(s) are 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 command adds the row(s) at the end of each array. If it is equal to 0, the command adds the row(s) at the beginning of each array. If it contains a negative value, the command does nothing.

 
PROPERTIES 

Product: 4D
Theme: List Box
Number: 913

The OK variable is changed by the command

 
INDEX

Alphabetical list of commands

 
HISTORY 

New
Created: 4D 2004
Renamed: 4D v12
Modified: 4D v13
Renamed: 4D v13

 
SEE ALSO 

LISTBOX DELETE ROWS