insertRow()

insertRow() is used to insert a row to the given position of the list. The method execution does not influence the cursor position nor initiates AFTER ROW / BEFORE ROW and AFTER INSERT / BEFORE INSERT control blocks. The method performance is similar to inserting a new row to the program array. The difference is that the internal registers are updated automatically. If multi-row selection is enabled in the current dialog, the selected rows will stay selected after the method execution.

The syntax of the method is:

CALL DIALOG.InsertRow("screen_array", index)

screen_array is the name of the screen array in the current dialog. The index argument is the index of the newly created row.

insertRow() is used only to insert a new row to the current screen array list and does not fill it with any values. To focus the new row, use SetCurrentRow().

insertRow() must not be used in AFTER ROW / BEFORE ROW, AFTER INSERT / BEFORE INSERT, AFTER DELETE / BEFORE DELETE blocks.  However, you can use it in an ON ACTION block.

If you want to take control of the treeview, use insertNode() method instead of insertRow().