.. highlightlang:: us

.. _tablesettext:

TableSetText
============

.. index:: TableSetText

.. us.tag  TableSetText table.set New400

Tauscht den vorhandenen Test einer Zelle, einer Auswahl von Zellen oder
in alle Zellen aus.

.. function::  bool = TableSetText(hTable, smText, rvRowCol)
    bool = TableSetText(hTable, smText)
    bool = TableSetText(hTable, smText, 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:: smText

   *smText* ist eine Stringmatrix. Falls die Funktion mit zwei Parametern
   aufgerufen wird, muss die Anzahl der Zeilen und Spalten der Matrix mit 
   der Anzahl der Zeilen und Spalten des Tabellenobjekts übereinstimmen. 
   Falls die Funktion mit drei Parametern aufgerufen wird, muss die 
   die Anzahl der Zeilen und Spalten der Matrix mit der Selektion im Parameter
   *rvSel* übereinstimmen.

.. uparam:: rvSel

   *rvSel* ist ein Vektor mit vier Elementen:

   .. 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 Nummerierung beginnt mit 1. *svSel* bestimmt, welche Zellen der Tabelle
   auf einen neuen Wert gesetzt werden.

.. uparam:: rvRowCol

   *rvRowCol* ist ein Vektor mit zwei Elementen. Falls die Funktion mit drei
   Parametern aufgerufen wird und der dritte Parameter *rvRowCol* ein Vektor mit
   zwei Elementen ist, wird nur der Text der angegebenen Zelle überschrieben. Der
   Parameter *smText* sollte bei diesem Aufruf nur ein Element enthalten. Die
   Elemente des Vektors *rvRowCol* haben die folgende Bedeutung:

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

      * - Element
        - Beschreibung
      * - rvRowCol[1]
        - Zeilennummer
      * - rvRowCol[2]
        - Spaltennummer

.. us.comment

**Kommentar**

Im Zellentext können Feldfunktionen eingefügt werden, die dann bestimmte Aktionen
bzw. einen Ergebnistext erzeugen, z. B. @f{date}{25.02.2003}. Bei dieser
Feldfunktion wird beispielsweise der Text 25.02.2003 ausgegeben. Einen
Zeilenumbruch wird durch die folgende Zeichenfolge erreicht: ``\n`` oder ``\r\n``.
Weitere Informationen über die Texteingabe finden Sie unter
:ref:`objekt-bearbeitentext`. Falls die Zellentexte als Zahlen formatiert werden
sollen, muss als Dezimaltrennzeichen ein Punkt verwendet werden.

.. seealso::
   :ref:`uberblick-tabellenobjekt`,
   :ref:`TableGetText`,
   :ref:`TableGetName`

:sub:`id-1724895`