.. highlightlang:: us

.. index:: TableAddPen

.. _tableaddpen:

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

.. us.tag  TableAddPen table.pens New400

:ref:`TableAddPen` fügt der Penliste einer Tabelle einen neuen Zeichenstift zu. 
Der Zeichenstift legt fest mit welcher Farbe und welcher Linienstärke die 
Zellenrandlinien ausgegeben werden sollen.

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

.. us.return

**Returnwert**

*nPenIndex* liefert den Index des Pens. Damit der neue Pen für die gewünschten
Zellen verwendet werden kann, muss der Index über die Funktion
:ref:`TableSetBorderPenIndex` gesetzt werden. 

.. us.params

**Parameter**

.. uparam:: hTable

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

.. uparam:: hPen

   *hPen* ist die Zugriffsnummer eines mit :ref:`PenCreate` erzeugten Pens.
   Nachdem der Pen zugefügt wurde (es wird eine Kopie erzeugt), muss der Pen
   wieder gelöscht werden.

.. seealso::
   :ref:`uberblick-tabellenobjekt`,
   :ref:`TableSetBorderPenIndex`

:sub:`id-1003973`