.. highlightlang:: us

.. _tablesetformatindex:

TableSetFormatIndex
===================

.. index:: TableSetFormatIndex

.. us.tag  TableSetFormatIndex table.set New400

:ref:`TableSetFormatIndex` setzt die Indizes der Formatierung für die 
Ausgabe der Zellen.

.. function::  bool = TableSetFormatIndex(hTable, rmFormatIndex)
    bool = TableSetFormatIndex(hTable, rmFormatIndex, 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:: rmFormatIndex

   *rmFormatIndex* ist eine Matrix mit den Nummern (Index) der Formatierung. Der
   Index ist die Zeilennummer der Formatierung in der Formattabelle, die mit der
   Funktion :ref:`TableGetFormatList` erfragt werden kann.

.. uparam:: rvSel

   *rvSel* ist ein Vektor mit vier Elementen, der einen Bereich
   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**

::

   hDoc = DocCreate()
   hPage = PageCreate();
   DocAddPage(hDoc, hPage);
   hvLayer  =  PageGetAllLayers(hPage)
   // 1. Layer ist der Hindergrund
   hLayer = hvLayer[1];
   hTable = TableCreate(2, 12);  // 2 Spalten, 12 Zeilen
   rmData = rand(10,2) // 10*2 Matrix mit Zufallswerten
   smMatrix = smprintf("%.10lf", rmData); // 10*10 String-Matrix mit 10 Nachkommastellen
   smMatrix = ["x", "y"; "Nm", "kg"; smMatrix];
   TableSetText(hTable, smMatrix);
   iFormat = TableAddFormat(hTable, 2, "%.2lf"); // Zahlen mit 2 Nachkommastellen anzeigen.
   TableSetFormatIndex(hTable, zeros(12,2) + iFormat)
   OBJSetPosSize(hTable, [10,-10, 0, 0]);
   LayerAddObjects(hLayer, hTable);

.. seealso::
   :ref:`uberblick-tabellenobjekt`,
   :ref:`TableGetFormatList`,
   :ref:`TableGetFormatIndex`,
   :ref:`TableAddFormat`

:sub:`id-549224`