.. highlightlang:: us

.. index:: TBSetFont

.. _tbsetfont:

TBSetFont
=========

.. us.tag  TBSetFont NOTREADYENGLISH TB_Set

:ref:`TBSetFont` sets the font for the specified text object.

.. function::  bool = TBSetFont(hText, hFont)

.. 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`

.. uparam:: hFont

   The handle of a font object created with :ref:`FontCreate`.

.. us.example

**Example**

Set font color to red.

::

   hFont = TBGetFont(hText);
   FontSetColorRGB(hFont, [255,0,0]); // red 
   TBSetFont(hText, hFont);
   FontDestroy(hFont);

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

:sub:`id-296593`