.. highlightlang:: us

.. index:: TableAddPen

.. _tableaddpen:

TableAddPen
===========

.. us.tag  TableAddPen table.pens New400

:ref:`TableAddPen` adds a pen to the list of pens of the specified table object.

.. function::  nPenIndex = TableAddPen(hTable, hPen)

.. us.return

**Return Value**

*nPenIndex* is the pen index. The pen index is used to set the pen of the
cells, using the :ref:`TableSetBorderPenIndex` function.

.. us.params

**Parameters**

.. uparam:: hTable

   Identifies the table object.

.. uparam:: hPen

   *hPen* is the pen handle.

.. seealso::
   :ref:`overview-table`,
   :ref:`TableSetBorderPenIndex`

:sub:`id-1003973`