.. highlightlang:: us

.. index:: TBSetText

.. _tbsettext:

TBSetText
=========

.. us.tag  TBSetText GERMAN TB_Set

:ref:`TBSetText` tauscht den vorhandenen Text eines Text-Objekts durch einen neuen
Text aus.

.. function::  bool = TBSetText(hText, ssText)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Funktion erfolgreich war und
FALSE (0) bei Auftreten eines Fehlers.

.. us.params

**Parameter**

.. uparam:: hText

   *hText* ist die Zugriffsnummer (Handle) des mit
   :ref:`TBCreate` erzeugten Text-Objekts.

.. uparam:: ssText

   *ssText* ist der neue Text des Text-Objekts. Der Text kann beliebig lang sein.

.. us.comment

**Kommentar**

Im Zellentext können Feldfunktionen eingefügt werden, die dann bestimmte Aktionen
bzw. einen  Ergebnistext erzeugen, z. B. @f{date}{25.02.2003}. Bei dieser
Feldunktion wird beispielsweise der Text 25.02.2003 ausgegeben.Einen Zeilenumbruch wird durch die folgende Zeichenfolge erreicht: ``\n`` oder
``\r\n``. Weitere Informationen über die Texteingabe finden Sie unter
:ref:`objekt-bearbeitentext`

.. us.example

**Beispiel**

::

   hText = TBCreate();
   TBSetText(hText, "First line\nSecond Line\nThird Line");

.. seealso::
   :ref:`uberblick-textobjekte`,
   :ref:`TBGetText`,
   :ref:`TBCreate`,
   :ref:`objekt-bearbeitentext`

:sub:`id-741853`