.. highlightlang:: us

.. _tablegettextext:

TableGetTextExt
===============

.. index:: TableGetTextExt

.. us.tag  TableGetTextExt table.get New400

Liefert die Textausdehnung einer Spalte der Tabelle.

.. function::  rmExtend = TableGetTextExt(hTable, iCol)
    rmExtend = TableGetTextExt(hTable, iCol, iRow)

.. us.return

**Returnwert**

*rmExtend* ist eine Matrix mit der Textausdehnung der Texte in cm. 
In Spalte 1 steht die Breite und in Spalte 2 steht die Höhe der Texte.
Falls die Funktion mit den Parameter *iRow* aufgerufen wird,
enthält *rmExtend* die Breite und Höhe einer Zelle.

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

   * - Wert
     - Bedeutung
   * - rvExtend[;1]
     - Breite des Textelements in cm.
   * - rvExtend[;2]
     - Höhe des Textelements in cm.

.. us.params

**Parameter**

.. uparam:: hTable

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

.. uparam:: iCol

   *iCol* ist der Index einer Spalte. Der Spaltenindex beginnt mit 1.

.. uparam:: iRow

   *iRow* ist der Index einer Zeile. Der Zeilenindex beginnt mit 1.

.. us.comment

**Kommentar**

Das Tabellen-Objekt muss vorher einem Layer zugewiesen worden sein.

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

:sub:`id-196858`