ui.Dialog.insertRow()

The InsertRow() method 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 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 reference is:

 

DIALOG.InsertRow("screen_array", index)

 

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

 

The InsertRow() method 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 the SetCurrentRow() method.

 

The InsertRow() method must not be used in BEFORE ROW/AFTER ROW, BEFORE INSERT/AFTER INSERT, BEFORE DELETE/AFTER 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 the InsertRow().

 

 

Related topics:

ui.Dialog.setCurrentRow()

ui.Dialog.insertNode()