.. highlightlang:: us

.. _tableaddfont:

TableAddFont
============

.. index:: TableAddFont

.. us.tag  TableAddFont table.fonts New400

:ref:`TableAddFont` fügt der Fontliste einer Tabelle einen neuen Font zu.

.. function::  nFontIndex = TableAddFont(hTable, hFont)

.. us.return

**Returnwert**

*nFontIndex* liefert den Index des Fonts. Damit der 
neue font für die gewünschten Zellen verwendet wird, muss
der Index über die Funktion :ref:`TableSetFontIndex` gesetzt
werden.

.. us.params

**Parameter**

.. uparam:: hTable

   *hTable* ist die Zugriffsnummer (Handle) des mit
   :ref:`TableCreate` erzeugten Tabellen-Objekts.

.. uparam:: hFont

   *hFont* ist die Zugriffsnummer eines mit :ref:`FontCreate`
   erzeugten Fonts. Nachdem der Font zugefügt wurde (es wird
   in der Tabelle eine Kopie erzeugt), muss der Font wieder gelöscht 
   werden.

.. us.example

**Beispiel**

Im folgenden Beispiel wird ein neuer Font erzeugt und der Fontliste
zugefügt. Damit die Texte der ersten Zeile mit dem neuen Font 
dargestellt werden wird der Index mit der Funktion :ref:`TableSetFontIndex` 
gesetzt.

::

       hFont = FontDialog();  // erzeugt den Font
       idx = TableAddFont(hTable, hFont);
       FontDestroy(hFont);
       rvSize = TableGetSize(hTable);
       rmIndex = zeros(1, rvSize[2]) + idx;
       rvSel = [1, 1, rvSize[2], 1];
       TableSetFontIndex(hTable, rmIndex, rvSel);

.. seealso::
   :ref:`uberblick-tabellenobjekt`,
   :ref:`TableGetFontList`,
   :ref:`TableGetFontIndex`,
   :ref:`TableSetFontIndex`

:sub:`id-1855002`