.. highlightlang:: us

.. _tableinsertcolumn:

TableInsertColumn
=================

.. index:: TableInsertColumn

.. us.tag  TableInsertColumn table.set New400

:ref:`TableInsertColumn` inserts a new column of cells to the specified table.

.. function::  bool = TableInsertColumn(hTable, nAfter)

.. us.return

**Return Value**

If the function succeeds, the return value *bool* is TRUE (1); otherwise
it is FALSE (0).

.. us.params

**Parameters**

.. uparam:: hTable

   Identifies the table object.

.. uparam:: nAfter

   *nAfter* is the insert position. To insert the column of cells before the
   first column *nAfter* is 0. To add the column of cells after the last column
   set *nAfter* to a high value, e.g. 1000.

.. seealso::
   :ref:`overview-table`,
   :ref:`TableGetSize`,
   :ref:`TableInsertRow`

:sub:`id-1078853`