.. highlightlang:: us

.. index:: Edit Object=>Text
.. index:: y^edit-object-text

.. _edit-objecttext:
.. _edit-object-text:

Edit Object=>Text
-----------------

A Text Object can have multiple lines. You can use special characters and ANSI 
or Unicode character sets. Characters or series of characters can be printed in
sub- or superscript. The text can contain lines, arrows and symbols
symbols.

.. image:: S:/uniplot-obj/images/EditObjectText-en.*

.. us.dlgitem

**Text box**
   Edit the text in this box. See :ref:`text-objects`.

.. us.dlgitem

**Automatic Word Wrap**
   If the current word extends the line length (with of the text box), 
   the word will be placed on a new line. Single newline symbols (``"\r\n"``) will
   be ignored. Multiple consecutive newline symbols will remain.
   The word wrap will only take place at blank characters.

   If the option **Automatic Size Update** in the dialog page
   :ref:`edit-objectposition-and-size` is marked the text box height
   is calculated automatically.

.. us.dlgitem

**Clip Text**
   If this option is marked the text is clipped at the text box.

.. us.dlgitem

**Align Hori.**
   Sets the horizontal text alignment.

.. us.dlgitem

**Align Vert.**
   Sets the vertical text alignment.

.. us.dlgitem

**Direction**
   Rotates the text by +90 or -90 degrees.

.. us.dlgitem

**Edge Distance**
   Sets the distance between the left and upper 
   frame and the text in centimeters.

.. us.dlgitem

**Frame**
   Click this button to change frame attributes.

.. us.dlgitem

**Font**
   Click this button to change the font, the font size and other font attributes,

.. us.comment

**Comment**

.. index:: Text Objects; Field Functions
.. index:: Field Functions
.. index:: Field Functions; File Name
.. index:: Legend

**Text-Objects**

In the text of an object you can use special characters and the ANSI or Unicode 
character sets. Characters or series of characters can be printed in sub- or 
superscript. Text can contain lines, arrows and symbols.
See :ref:`text-objects`.

Field functions are especially coded strings in text fields. They can be used to
update information in documents automatically. They can be used with table or
text drawing objects.

**Example**: The file name is displayed as a text box in a UniPlot document page.
If the document is saved under a new name the field is updated and displays the
new name.

**Solution**: Create a text box and type the following text:
``@f{documentname}``. Instead of the string ``@f{documentname}`` the file name
is displayed, e.g. :file:`c:\\test.ipw`.

.. seealso::
   :ref:`edit-objectpattern`,
   :ref:`edit-objectcolor-gradient`,
   :ref:`edit-objectposition-and-size`,
   :ref:`edit-objectproperties`

:sub:`id-697636`