.. highlightlang:: us

.. _tablegetpenlist:

TableGetPenList
===============

.. index:: TableGetPenList

.. us.tag  TableGetPenList table.pens New400

:ref:`TableGetPenList` returns a vector with pen handles. A pen is used to draw 
the cell border line.

.. function::  hvPens = TableGetPenList(hTable)

.. us.return

**Return Value**

*hvPens* is a vector with the copied pen handles. After a pen is not longer used
it must be deleted using the :ref:`PenDestroy` function. The position of a pen
handle in the vector corresponds to the index in the table cell. The first
pen has the index 1. The index is set using the function :ref:`TableSetBorderPenIndex`. 
.. us.params

**Parameters**

.. uparam:: hTable

   Identifies the table object.

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

:sub:`id-2015466`