4D v12.4
LISTBOX INSERT ROW
- 4D Language Reference
-
- List Box
-
- Managing List Box Objects
- Managing Hierarchical List Boxes
- LISTBOX COLLAPSENew
- LISTBOX DELETE COLUMN
- LISTBOX DELETE ROW
- LISTBOX EXPANDNew
- LISTBOX GET ARRAYS
- LISTBOX GET CELL POSITION
- LISTBOX Get column widthUpd
- LISTBOX GET HIERARCHYNew
- LISTBOX Get information
- LISTBOX Get number of columns
- LISTBOX Get number of rows
- LISTBOX GET PRINT INFORMATIONNew
- LISTBOX Get rows height
- LISTBOX GET TABLE SOURCE
- LISTBOX INSERT COLUMN
- LISTBOX INSERT COLUMN FORMULA
- LISTBOX INSERT ROW
- LISTBOX MOVED COLUMN NUMBER
- LISTBOX MOVED ROW NUMBER
- LISTBOX SELECT BREAKNew
- LISTBOX SELECT ROW
- LISTBOX SET COLUMN WIDTHUpd
- LISTBOX SET GRID COLOR
- LISTBOX SET HIERARCHYNew
- LISTBOX SET ROWS HEIGHT
- LISTBOX SET TABLE SOURCE
- LISTBOX SHOW GRID
- LISTBOX SORT COLUMNS
LISTBOX INSERT ROW
| LISTBOX INSERT ROW ( {* ;} object ; vPosition ) | ||||||||
| 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) | |||||
| vPosition | Longint |
|
Position of the row to insert | |||||
The LISTBOX INSERT ROW command inserts a new row 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.
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.
Product: 4D
Theme: List Box
Number:
913
Created: 4D 2004
Renamed: 4D v12
