# InsertTableRows

int InsertTableRows (int panelHandle, int controlID, int rowIndex, int numberOfRows, int cellType);

## Purpose

Inserts new rows into a table control at the specified one-based index.

The indexes of existing rows at and beyond the specified index are increased by the number of rows inserted.

This function creates a new cell for each column in the table.

## Parameters

Input
Name | Type | Description
panelHandle | integer | Specifier for a particular panel that is currently in memory. You obtain this handle from LoadPanel, NewPanel, or DuplicatePanel.
controlID | integer | The defined constant, located in the .uir header file, that you assigned to the control in the User Interface Editor, or the ID returned by NewCtrl or DuplicateCtrl.
rowIndex | integer | The one-based index into the table where the function inserts the first new row. Pass –1 to insert the first new rows at the end of the table.
numberOfRows | integer | The number of new rows to insert.
cellType | integer | The cell type of the cells that might be created as a result of creating the new rows. The following table lists the possible cell types.
Constant Name | Constant Value
VAL_CELL_NUMERIC | 0
VAL_CELL_STRING | 1
VAL_CELL_PICTURE | 2
VAL_CELL_RING | 3
VAL_CELL_COMBO_BOX | 4
VAL_CELL_BUTTON | 5
Pass VAL_USE_MASTER_CELL_TYPE (–1) if you want the cell types to be the default cell types for each column. Refer to ATTR_TABLE_MODE.

## Return Value

Name | Type | Description
status | integer | Return value indicating whether the function was successful. A negative number indicates that an error occurred.
Code | Error Message String
xx | Success