.. highlightlang:: us

.. _tableinsertrow:

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

.. index:: TableInsertRow

.. us.tag  TableInsertRow table.set New400

:ref:`TableInsertRow` fügt eine neue Zeile ein.

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

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Funktion erfolgreich war und
FALSE (0), wenn ein Fehler aufgetreten ist.
.. us.params

**Parameter**

.. uparam:: hTable

   *hTable* ist die Zugriffsnummer (Handle) des mit
   :ref:`TableCreate` erzeugten Tabellen-Objekts.

.. uparam:: nAfter

   *nAfter* gibt die Zeile an, nach der die neue Zeile eingefügt 
   werden soll. Wenn die Zeile vor der ersten Zeile eingefügt werden soll,
   muss *nAfter* einen Wert kleiner oder gleich 0 haben. Soll die Zeile hinter 
   der letzten Zeile  eingefügt werden, kann *nAfter* auf einen großen 
   Wert gesetzt werden (z. B. 1000).

.. seealso::
   :ref:`uberblick-tabellenobjekt`,
   :ref:`TableGetSize`,
   :ref:`TableInsertColumn`

:sub:`id-601844`