.. highlightlang:: us

.. _tablegettext:

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

.. index:: TableGetText

.. us.tag  TableGetText table.get New400

:ref:`TableGetText` returns a matrix of cell text. 

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

.. us.return

**Return Value**

*smText* is a string matrix with the cell text. If the function was invoked 
without parameters the string matrix contains the text of all cells otherwise
the matrix contains the cell text of the specified cell range. 

.. us.params

**Parameters**

.. uparam:: hTable

   Identifies the table object.

.. uparam:: rvSel

   *rvSel* is a vector with four elements specifying a range of rows and columns:

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

      * - Element
        - Description
      * - rvSel[1]
        - Left column of selection
      * - rvSel[2]
        - Top row of selection
      * - rvSel[3]
        - Right column of selection
      * - rvSel[4]
        - Bottom row of selection

   The column and row numbering starts with 1. Left is smaller than right and
   top is smaller than bottom.

.. seealso::
   :ref:`overview-table`,
   :ref:`TableSetText`,
   :ref:`TableSetName`

:sub:`id-965990`