.. highlightlang:: us

.. _tablesetfontindex:

TableSetFontIndex
=================

.. index:: TableSetFontIndex

.. us.tag  TableSetFontIndex table.fonts New400

:ref:`TableSetFontIndex` setzt die Indizes des Fonts (Schriftart) für die 
Ausgabe der Texte.

.. function::  bool = TableSetFontIndex(hTable, rmFontIndex)
    bool = TableSetFontIndex(hTable, rmFontIndex, rvSel)

.. us.return

**Returnwert**

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

.. us.params

**Parameter**

.. uparam:: hTable

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

.. uparam:: rmFontIndex

   *rmFontIndex* ist eine Matrix mit den Nummern (Index) der Fonts. Der
   Index ist die Nummer des Fonts in der Fonttabelle des Tabellenobjekts.
   Die Nummern der Fonts können mit der Funktion :ref:`TableGetFontList` erfragt werden.

.. uparam:: rvSel

   *rvSel* ist ein Vektor mit vier Elementen, der einen Zellenbereich
   der Tabelle auswählt:

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

      * - Element
        - Beschreibung
      * - rvSel[1]
        - Linke Zelle der Selektion
      * - rvSel[2]
        - Obere Zelle der Selektion
      * - rvSel[3]
        - Rechte Zelle der Selektion
      * - rvSel[4]
        - Untere Zelle der Selektion

   Die Spalten- und Zeilennummerierung beginnt mit 1. 

.. us.example

**Beispiel**

::

   def Table_SetFontColor(hTable, nRow, nColumn, rvRGB)
   {
       rmFontIndex = TableGetFontIndex(hTable);
       hvFont = TableGetFontList(hTable);
       FontSetColorRGB(hvFont[rmFontIndex[nRow;nColumn]], rvRGB);
       nFontIndex = TableAddFont(hTable, hvFont[rmFontIndex[nRow;nColumn]]);
       rmFontIndex[nRow;nColumn] = nFontIndex;
       TableSetFontIndex(hTable, rmFontIndex);
       FontDestroyArray(hvFont);
   }
   Table_SetFontColor(21, 3, 1, [255,127,0])

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

:sub:`id-488022`