.. highlightlang:: us

.. _tableinsertrow:

TableInsertRow
==============

.. index:: TableInsertRow

.. us.tag  TableInsertRow table.set New400

:ref:`TableInsertRow` inserts a new row of cells to the specified table.

.. function::  bool = TableInsertRow(hTable)
    bool = TableInsertRow(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 row of cells before the
   first row *nAfter* is 0. To add the row of cells at the bottom of the 
   table set *nAfter* to a high value, e.g. 1000.

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

:sub:`id-601844`