.. highlightlang:: us

.. _tablegettext:

TableGetText
============

.. index:: TableGetText

.. us.tag  TableGetText table.get New400

Liefert den Text einer Auswahl von Zellen oder von allen Zellen zurück.

.. function::  smText = TableGetText(hTable)
    smText = TableGetText(hTable, rvSel)

.. us.return

**Returnwert**

*smText* ist eine Stringmatrix. Falls die Funktion mit einem Parameter aufgerufen
wird, enthält die Stringmatrix die Texte aller Zellen. Bei Aufruf mit zwei
Parametern enthält die Matrix soviele Zeilen und Spalten wie durch den Parameter
*rvSel* angegeben.
.. us.params

**Parameter**

.. uparam:: hTable

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

.. 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 Zellennummerierung beginnt mit 1. 
   *svSel* bestimmt, für welche Zellen der Tabelle der Text zurückgeliefert werden soll.

.. seealso::
   :ref:`uberblick-tabellenobjekt`,
   :ref:`TableSetText`,
   :ref:`TableSetName`

:sub:`id-965990`