InsertTableColumns

int InsertTableColumns (int panelHandle, int controlID, int columnIndex, int numberOfColumns, int cellType);

Purpose

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

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

This function creates a new cell for each row 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.
columnIndex integer The one-based index into the table where the first new column is placed.

Pass –1 to insert the new columns at the end of the table.
numberOfColumns integer The number of new columns to insert.
cellType integer The cell type of the cells that might be created as a result of creating the new columns. 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 row. 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