.. highlightlang:: us

.. index:: TBGetTextExtend

.. _tbgettextextend:

TBGetTextExtend
===============

.. us.tag  TBGetTextExtend NOTREADYENGLISH TB_Get

:ref:`TBGetTextExtend` returns text size, which
is necessary to print the text.

.. function::  rvExtend = TBGetTextExtend(hText)

.. us.return

**Return Value**

*rvExtend* is a vector with 2 elements:

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

   * - Value
     - Meaning
   * - rvExtend[1]
     - Width of the text element in cm.
   * - rvExtend[2]
     - Height of the text element in cm.

.. us.params

**Parameters**

.. uparam:: hText

   The handle of a text object created with :ref:`TBCreate` .

.. us.comment

**Comment**

The text object must have been added to a layer (diagram).

.. seealso::
   :ref:`overview-text-objects`,
   :ref:`TBCreate`,
   :ref:`LayerAddObjects`,
   :ref:`OBJSetPosSize`

:sub:`id-1274495`