.. highlightlang:: us

.. index:: AppSetStatusBarText

.. _appsetstatusbartext:

AppSetStatusBarText
===================

.. us.tag  AppSetStatusBarText ENGLISH App Toolbar

:ref:`AppSetStatusBarText` prints text into
the status bar

.. function::  bool = AppSetStatusBarText(ssString1)
    bool = AppSetStatusBarText(ssString1, ssString2)
    bool = AppSetStatusBarText(ssString1, ssString2, ssString3)

.. us.return

**Return Value**

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

.. us.params

**Parameters**

.. uparam:: ssString1

   *ssString1* is the text for the left part of the status bar.

.. uparam:: ssString2

   *ssString2* is the text for the middle part of the status bar.

.. uparam:: ssString3

   *ssString3* is the text for the right part of the status bar.

.. us.comment

**Comment**

If one of the strings has the length 0, the status bar text will
not be changed.

.. us.example

**Example**

Print the string ``"Ready"`` in the middle field of the status
bar and leave the text in the other fields untouched:

::

   * AppSetStatusBarText("", "Ready");

.. seealso::
   :ref:`overview-application-object`,
   :ref:`AppSetBar`

:sub:`id-1496775`