.. highlightlang:: us

.. _auto_loadmatrixdataset:

auto_LoadMatrixDataset
======================

.. index:: auto_LoadMatrixDataset

.. us.tag  auto_LoadMatrixDataset GERMAN New5313

:ref:`auto_LoadMatrixDataset` lädt aus einer Datendatei ein Matrix und 
erzeugt davon einen 3D-Datensatz.

.. function:: hData = auto_LoadMatrixDataset(ssDiagram, ssFileName)

.. us.return

**Returnwert**

*hData* ist eine Zugriffsnummer, mit der auf den Datensatz zugegriffen werden
kann (siehe Beispiel).

.. us.params

**Parameter**

.. uparam:: ssDiagram

   *ssDiagram* ist der Name des Diagramms, in das der Datensatz ausgegeben werden
   soll. Bei einem leeren String wird der Datensatz erzeugt aber keinem Diagramm 
   zugefügt. In diesem Fall muss der Datensatz mit der Funktion 
   :ref:`LayerAddDataset` einem Diagramm zugewiesen werden.

.. uparam:: ssFileName

   *ssfileName* ist der Name einer Datendatei. die Matrix kann aus Text- oder 
   Excel-Dateien geladen werden. Bei Excel-Dateien kann der 
   Tabellenname in eckige Klammern an den Dateinamen angehängt werden. Falls
   der Name nicht angegeben ist, wird die Matrix aus der ersten Tabelle geladen.

.. us.comment

**Kommentar**

Hinweise zur Formatierung der Matrix finden Sie hier: 
:ref:`dateiweitere-datei-funktionen3d-daten-matrix-laden`

.. us.example

**Beispiel**

::

   hPage = auto_LoadTemplate("c:/mytemplate.ipw");
   // Sheet2 is the sheet name.
   hData = auto_LoadMatrixDataset("Diagramm 1", "c:/mymatrix.xls [Sheet2]");
   if (hData != 0) {
       hLayer = GetParent(hData);
	   LayerAutoScale(hLayer);
   }

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2011.13
     - Neu.

.. seealso::
   :ref:`uberblick-automatisierung-der-diagrammerstellung`,
   :ref:`auto_LoadTemplate`,
   :ref:`auto_SetTemplate`,
   :ref:`auto_LoadDataset`,
   :ref:`LayerAddDataset`,
   :ref:`GetParent`,
   :ref:`dateiweitere-datei-funktionen3d-daten-matrix-laden`

:sub:`id-1187082`