.. highlightlang:: us

.. index:: TBDestroy

.. _tbdestroy:

TBDestroy
=========

.. us.tag  TBDestroy ENGLISH TB_Create

:ref:`TBDestroy` destroys the given text object and frees any memory the text
object occupied.

.. function::  bool = TBDestroy(hText)

.. us.return

**Return Value**

If the function succeeds, the return value *bool* is TRUE (1); otherwise
it is FALSE (0).

.. us.params

**Parameters**

.. uparam:: hText

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

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

:sub:`id-1424217`