.. highlightlang:: us

.. _tablesetborderpenindex:

TableSetBorderPenIndex
======================

.. index:: TableSetBorderPenIndex

.. us.tag  TableSetBorderPenIndex table.pens New400

:ref:`TableSetBorderPenIndex` setzt für die Randlinien den Index des Zeichenstifts,
der für die Ausgabe verwendet werden soll. Jede Zelle wird von 4 Randlinien
umschlossen. 

.. function::  bool = TableSetBorderPenIndex(hTable, rmPenIndex, bHorz)
    bool = TableSetBorderPenIndex(hTable, rmPenIndex, bHorz, rvSel)

.. 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:: rmPenIndex

   *rmPenIndex* ist eine Matrix mit den Indizes der Stifte, die für die 
   Ausgabe der horizontalen oder vertikalen Randlinien verwendet werden sollen.
   Wenn der Parameter *bHorz* gleich TRUE (1) ist, muss die  die Matrix eine
   Zeile mehr haben als die Tabelle Zeilen hat oder als durch den Parameter
   *rvSel* angegeben ist. Wenn der Parameter *bHorz* gleich FALSE (0) ist, 
   muss die die Matrix eine Spalte mehr haben als die Tabelle Zeilen hat oder als 
   durch den Parameter *rvSel* angegeben ist.
   Falls der Wert 0 ist, wird keine Linie ausgegeben.
   
.. uparam:: bHorz

   *bHorz* hat den Wert TRUE (1), wenn die horizontalen Randlinien gesetzt werden 
   sollen und FALSE (0), wenn die vertikalen Randlinien gesetzt werden sollen.

.. uparam:: rvSel

   *rvSel* ist ein Vektor mit vier Elementen, der einen Zellenbereich
   der Tabelle auswählt:

   .. list-table::
      :header-rows: 1

      * - Element
        - Beschreibung
      * - rvSel[1]
        - Linke Zelle der Selektion
      * - rvSel[2]
        - Obere Zelle der Selektion
      * - rvSel[3]
        - Rechte Zelle der Selektion
      * - rvSel[4]
        - Untere Zelle der Selektion

   Die Spalten- und Zeilennummerierung beginnt mit 1. 

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

:sub:`id-14989`