interface data_table insert row
Allows you to insert row in a data table field.
The data table is similar to a excel workbook where a categorized data can be stored as array, locating each item by its row and column index. The data table can be created on a dialog box and the data is displayed using this command.
This command is used to insert rows in a data table.
Format:
interface data_table insert row |
|---|
data_table_name = | an existing GI_data_table |
row_number = | integer |
number_to_insert = | integer |
column_indices = | integer |
insert_action = | insert_actiion |
Example:
interface data_table insert row& |
|---|
data_table_name = | .gui.param.dtable & |
row_number = | 3 & |
number_to_insert = | 5 & |
column_indices = | 2,3 & |
insert_action = | before |
Description:
Parameter | Value Type | Description |
|---|
data_table _name | An Existing GI_data_table | Specifies the name of an existing data table |
row_number | Integer | Specifies the row number where the row are to be added |
number_to_insert | Integer | Specifies the number of rows to be added |
column_indices | Integer | Specifies the column index to which the row is added |
insert_action | Insert_action | Specifies whether the rows are to be added before or after the ‘row_number’ |
Extended Definition:
After creating the data table, the rows and columns can be created by using the ‘insert’ command.
The ‘row_number’ the row index where the row will be added . The number of rows added to this location are decided by the parameter ‘number_to_insert’. Similarly, the parameter ‘insert action’ decides whether the row will be added ‘before’ or ‘after’ the row indexed by the parameter ‘row_number’. As illustrated in the above example five rows will be added after second row shifting the row 3 to 8th place.
Tips:
The rows and columns created will be symmetric independent of the column indices specified.