TABLE-INSERT-ROW Action

This document covers the following topics:


Description

Inserts a row into a table. To do so, one of the table control's STYLE attribute values must be "e". Specifying the value "0" in the Row Index parameter is useful in combination with the insert-row event because the ROW attribute then contains the index of the row in which the end user has caused the most recent event.

Parameters

Name/Data Type Explanation
HANDLE OF TABLE Input

Specifies a Table Control.

Row Index (I4) Input

Specifies the number of the row before which the new row is to be inserted.

If you specify "0", the value of the table's ROW attribute is taken as the number of the row before which the new row is to be inserted.

If you specify "-1", the new row will be appended to the lat row in the table.

If you specify "1", the row to be inserted will become the first row in the table.

List of parameters Input

You can either specify one parameter for each column of the row, or you can specify less parameters than there are columns. If you specify more parameters than there are columns, an error message is returned.

Response (I4) Output

Natural error (if applicable).

Example:

 
   PROCESS GUI ACTION TABLE-INSERT-ROW WITH #TBL-1 3 #P1 #P2 #P3 #P4 
   GIVING #RESPONSE 
   PROCESS GUI ACTION TABLE-REFRESH WITH #TBL-1 GIVING #RESPONSE /* Recommended