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