.. highlightlang:: us

.. index:: TBSetWordWrap

.. _tbsetwordwrap:

TBSetWordWrap
=============

.. us.tag  TBSetWordWrap GERMAN TB_Set New500

:ref:`TBSetWordWrap` schaltet den automatischen Zeilenumbruch ein oder aus.

.. function::  bool = TBSetWordWrap(hText, bWordWrap)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Funktion erfolgreich war und sonst FALSE (0).

.. us.params

**Parameter**

.. uparam:: hText

   *hText* ist die Zugriffsnummer eines Texteobjekts.

.. uparam:: bWordWrap

   *bWordWrap* ist TRUE (1), wenn automatischer Zeilenumbruch eingeschaltet
   ist.

.. us.comment

**Kommentar**

Automatischer Zeilenumbruch (Word Wrap)

Überschreitet das aktuelle Wort die Zeilenlänge (Breite des Textrechtecks), 
wird das Wort automatisch an den Anfang einer neuen Zeile plaziert.
Einfache Zeilenumbruchsymbole (``"\r\n"``) werden ignoriert.
Mehrfache Zeilenumbruchsymbole bleiben erhalten. Der Umbruch wird nur an
Leerzeichen durchgeführt.

Wenn die Option **Größe automatisch anpassen** in der Dialogfeldseite
:ref:`objekt-bearbeitenposition-und-große-(text)` markiert ist, wird
die notwendige Höhe des Zeichenobjekts um alle Zeilen anzeigen zu können,
automatisch bestimmt.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.0.0
     - Neu

.. seealso::
   :ref:`uberblick-textobjekte`,
   :ref:`TBSetRefPoint`,
   :ref:`TBSetAutoSize`,
   :ref:`TBIsClipText`,
   :ref:`TBIsWordWrap`,
   :ref:`OBJSetPosWC`,
   :ref:`OBJGetRefPointWC`

:sub:`id-1696762`