.. highlightlang:: us

.. index:: Überblick Tabellenobjekt, Tabellenobjekt 

.. _uberblick-tabellenobjekt:
.. _overview-table:

Überblick Tabellenobjekt
========================

In Tabellen können Texte und Zahlen in Spalten angeordnet werden, ohne das
Tabulatorzeichen oder Leerzeichen verwendet werden müssen. 

Alle Eigenschaften und Funktionen eines Tabellenobjekts können über das 
Programmierinterface erreicht werden. Den Quellcode der Funktionen finden Sie in
den Dateien :file:`mn_table.ic` und :file:`obj_table.ic` im Verzeichnis 
:file:`uniplot\\script`. 

Ein kleines Beispiel
^^^^^^^^^^^^^^^^^^^^

::

   // autoload\AddMyTable.ic
   RegisterCommand("Tabelle", "AddMyTable", "Meine Tabelle einfügen")
   UserBar_AddCommand("AddMyTable")
   def AddMyTable()
   {
       hPage = AppGetActivePage();
       if (hPage == 0) return;
       hLayer = GetSelectedLayers();
       smText = ["Name", "Peter Müller"; "Abteilung", "MAB3"; "Projet", "1234"];
       hTable = TableCreate(smText);
       LayerAddObjects(hLayer, hTable);
       PageReplot(hPage);
   }

Füllfarben, Fonts, Randlinie, Format
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Für die Füllfarben der Zellen, die verwendeten Fonts und die Randlinien werden in jeder
Tabelle entsprechende Listen geführt. In jeder Zelle wird nur ein Verweis (Index) auf 
die entsprechenden Elemente gespeichert. Wenn beispielsweise ein Bereich von Zellen mit
einem speziellen Font ausgegeben werden sollen, erzeugt man zuerst den neuen Font,
fügt den Font mit der Funktion :ref:`TableAddFont` in die Liste ein. Die Funktion liefert den
Index des neuen Fonts zurück. Mit dem Index kann dann für die gewünschten Zellen 
der Font über die Funktion :ref:`TableSetFontIndex` gesetzt werden. Der Index beginnt mit
dem Wert 1. Für ein Programmbeispiel siehe :ref:`TableAddFont` oder :ref:`TableAddBrush`.

Bei Füllfarben ist zu beachten, das der Index 0 eine besondere Bedeutung hat. Um eine
Zelle mit transparenter Füllung auszugeben, wird der Index 0 über die Funktion 
:ref:`TableSetBrushIndex` übergeben.

Position und Größe
^^^^^^^^^^^^^^^^^^

Die Postion und Größe wird mit der Funktion :ref:`OBJSetPosSize` gesetzt. 

Funktionen
^^^^^^^^^^

.. us.makeindex   table.create, Erzeugen und Zerstören

.. include:: ../ftab/table-create.ftab

.. us.makeindex   table.set, Setzen

.. include:: ../ftab/table-set.ftab

.. us.makeindex   table.get, Erfragen

.. include:: ../ftab/table-get.ftab

.. us.makeindex   table.fonts, Fonts

.. include:: ../ftab/table-fonts.ftab

.. us.makeindex   table.brush, Füllfarben

.. include:: ../ftab/table-brush.ftab

.. us.makeindex   table.pens, Rahmenlinien

.. include:: ../ftab/table-pens.ftab

:sub:`id-955647`