.. highlightlang:: us

.. index:: Browser=>Datentabelle erzeugen
.. index:: Eingebettete Datentabelle
.. index:: y^browser-create-embedded-data-table

.. _browser-create-embedded-data-table:
.. _browser--create-embedded-data-table:
.. _browser--eingebettete-datentabelle-erzeugen:

Browser=>Eingebettete Datentabelle erzeugen
-------------------------------------------

Die Funktion erzeugt von den im Browser ausgewählten Kanäle eine Tabelle.
Die Tabelle kann maximal 128 Zeilen und 128 Spalten enthalten.

Um eine Tabelle zu erzeugen wählen Sie im Daten-Browser im Typ-Feld
``Text: Datentabelle`` aus. Markieren Sie danach in der Kanalliste 
die gewünschten Kanäle. Die ausgewählten Kanäle können dann mit der Maus 
auf die Seite gezogen werden. 

.. image:: S:/uniplot-obj/images/Embedded-Data-Table.*

Ein Doppelklick auf die Tabelle öffnet das Konfigurationsdialogfeld der 
Datentabelle.

.. image:: S:/uniplot-obj/images/embedded-datatable-config-dialog-de.*

.. us.dialog

.. index::  Eingebettete Datentabelle

.. us.dlgitem

**Kanalliste**
   Das Listenfeld enhält für jeden Kanal eine Zeile.

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

      * - Spalte
        - Bedeutung
      * - Kanalname
        - Über das Kombinationsfeld kann ein Kanal ausgewählt werden.
      * - Titel
        - Wenn das Feld leer ist, wird der Kanalname als Titel in der Tabelle angezeigt.
      * - Einheit
        - Wenn das Feld leer ist, wird die Einheit aus der NC-Datei in der Tabelle angezeigt.
      * - Zahlenformat
        - Für Zahlenkanäle kann ein Format in der Form 00.00 eingegeben werden. Die Anzahl der Ziffern hinter dem Dezimalpunkt bestimmt dann die Anzahl der Nachkommastellen.
      * - Bedingte Formatierung
        - Über den Schalter ``...`` kann eine bedingte Formatierung definiert werden. Damit kann in Abhängigkeit vom Zahlenwert die Füllfarbe der Zelle festgelegt werden.

.. us.dlgitem

**NC Datei**
   Zeigt den Namen der ausgewählten Datendatei (NC-Datei). Über den Schalter 
   ``...`` kann eine andere Datei ausgewählt werden.

.. us.dlgitem

**Bearbeiten**
   Öffnet das Dialogfeld zum Bearbeiten der Daten.

.. us.dlgitem

**Zufügen**
   Fügt hinter der Markierung eine neue Zeile (Kanal) ein.

.. us.dlgitem

**Löschen**
   Löscht die markierten Kanäle.

.. us.dlgitem

**Nach Oben**
	Verschiebt die markierten Kanäle nach oben.

.. us.dlgitem

**Nach Unten**
	Verschiebt die markierten Kanäle nach unten.

.. us.dlgitem

**Spaltenanzahl und Zeilenanzahl automatisch schrumpfen**

   Wenn die Option markiert ist, werden nicht mehr benötigte Zeilen und Spalten
   aus der Tabelle gelöscht.

.. us.dlgitem

**Kanalname anzeigen**

   Wenn die Option markiert ist, wird der Titel in der ersten Zeile der Tabelle
   angezeigt.

.. us.dlgitem

**Kanaleinheit anzeigen**

   Wenn die Option markiert ist, wird die Einheit oberhalb der ersten Datenzeile
   angezeigt.

.. us.dlgitem

**Rekordauswahl**

   Legt die Zeilen der Messdaten in der Tabelle fest, die ausgegeben werden 
   sollen. Um beispielsweise nur die ersten 10 Zeilen auszugeben, geben Sie 
   1 bis 10 ein. Um die letzten 10 Zeilen auszugeben, können Sie die Werte -10
   bis -1 eingeben. Negative Zeilennummern zählen vom Ende der Datei. -1 ist
   dann die Zeilennummer der letzten Zeile. Wenn Sie die Rekordauswahl verwenden,
   wird der Rekordfilter, der in der NC-Datei definiert ist, ignoriert.

.. us.dlgitem

**Maximale Zeilenanzahl**

   Legt die maximal Anzahl der Zeilen in der Tabelle fest. Die Zahl sollte so 
   festgelegt werden, dass die Tabelle in Abhängikeit von der ausgewählten
   Fontgröße vollständig auf der Seite angezeigt werden kann.

.. us.dlgitem

**Kanäle in Zeilen ausgeben**

  Ausgabe der Kanäle in Zeilen.

.. us.dlgitem

**Zellfarben verwenden**

  Wenn die Option nicht markiert ist, können die Zellfarben über die 
  Tabellen-Schalterleiste eingestellt werden. 

.. us.dialog

.. us.comment

**Kommentar**

Die Formatierung der Tabelle kann mit Hilfe der Schalterleisten 
(Font, Textausrichtung, etc.) eingestellt werden.

Der Inhalt der Tabelle kann über die Funktion :ref:`datendatenaustausch-(seite)`
ausgetauscht werden.

Das Tabellenobjekt erhält den Namen ``nc_datatable``. Innerhalb einer 
Skriptfunktion kann die Tabelle in einer Seite mit der Funktion
:ref:`PageGetObjectHandle` gesucht werden. Der Name kann bei Bedarf über einen
Rechtsklick=>Konfiguration in der Tabelle geändert werden.

UniScript-Schnittstelle
^^^^^^^^^^^^^^^^^^^^^^^
Das folgende Skript erzeugt eine eingebettete Tabelle.

::
	
   ...
   obj = DataTable_CreateObject();
   obj.ssNCFile = "c:/data.nc";
   smMatrix = ["EngSpd", "N", "1/min", "0000.0"; 
               "PME", "", "", "00.00";
               "Fuel", "be", "g/kWh", "000.0";
               "SB", "", "", "";
               "SZ", "", "", "";
               "TKWA", "", "", "00.00";
               "P0", "", "", "";
               "Alpha", "", "", ""];

   obj.smMatrix = smMatrix;
   hTable = OnDataTable_AddEmbedded(hLayer, obj);
   OBJSetPosSize(hTable, [3, -3, 1, 1]);
   ...

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.30.5
     - Neu

.. seealso::
   :ref:`uberblick-browser-window`,
   :ref:`data-browser`

:sub:`id-762435`