.. highlightlang:: us

.. _tablegetpenlist:

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

.. index:: TableGetPenList

.. us.tag  TableGetPenList table.pens New400

:ref:`TableGetPenList` liefert alle Penhandle (Zugriffsnummern) der Penliste
als Vektor zurück. Ein Pen ist ein Zeichenstift. Er legt die Farbe und die 
Linienstärke der Randlinien der Zellen fest.

.. function::  hvPens = TableGetPenList(hTable)

.. us.return

**Returnwert**

*hvPens* ist ein Vektor mit den Kopien der Pen-Zugriffsnummern (Handle).Nachdem
die Pen-Zugriffsnummern nicht mehr benötigt werden, müssen Sie gelöscht 
werden (:ref:`PenDestroy`). Die Position eines Pens im Vektor entspricht dem Index 
des Pens. Der Pen des ersten Elements hat also den Index 1, das zweite Element
den Index 2 usw. Der Index wird verwendet um einen Pen für die Randlinie
einer Zelle der Tabelle mit Hilfe der Funktion :ref:`TableSetBorderPenIndex` zu
setzen. 

.. us.params

**Parameter**

.. uparam:: hTable

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

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

:sub:`id-2015466`