.. highlightlang:: us

.. index:: auto_xyz_CrossSectionXY

.. _auto_xyz_CrossSectionXY:

auto_xyz_CrossSectionXY
=======================

.. us.tag  auto_xyz_CrossSectionXY NOTREADYGERMAN auto_xyz Changed5400

:ref:`auto_xyz_CrossSectionXY` berechnet einen Kennfeldschnitt entlang einer
gegebenen 2D-Kurve.

.. function::  hDataNew = auto_xyz_CrossSectionXY(hData, hData2, nType)
               hDataNew = auto_xyz_CrossSectionXY(hData_Layer, hData2, nType)

.. us.return

**Returnwert**

*hDataNew* ist die Zugriffsnummer des neu erzeugten 3D-Datensatzes.

.. us.params

**Parameter**

.. uparam:: hData

  *hData* ist die Zugriffsnummer (Handle) des 3D Datensatzes auf den die Funktion
  angewendet werden soll. Der erzeugte Datensatz *hDataNew* wird dem Diagramm
  zugefügt, in dem sich *hData* befindet.

.. uparam:: hData_Layer

  *hData_Layer* ist ein Vektor von
  Zugriffsnummern. Das erste Element ist die Zugriffsnummer (Handle) des
  Datensatzes auf den die Funktion angewendet werden soll. Das zweite
  Element ist die Zugriffsnummer (Handle) des Diagramms, dem der neue
  Datensatz zugefügt werden soll.

.. uparam:: hData2

   *hData2* ist die Zugriffsnummer (Handle) eines
   2D-Datensatzes.

.. uparam:: nType 

   *nType* ist einer der folgenden Werte:

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

      * - Wert
        - Bedeutung
      * - 1
        - x-Koordinaten sind die Projektion auf die x-Achse.
      * - 2
        - x-Koordinaten sind die Projektion auf die y-Achse.
      * - 3
        - x-Koordinaten sind die Kurvenlänge.

.. us.example

**Beispiel**

**Example**

The following example will creates a cross section at the specified 
coordinates:

::

   auto_AddToUI("Examples", "Example 1: Map Cross Section", "RS_Example_CS");

   def RS_Example_CS()
   {
       MessageBox("In the following dialog please select the file map-data.xls");
       auto_SetFileNameDialogInit("*.xls", GetRootDirectory() + "samples/");
       svFile = auto_GetFileNameDialog(1);
       if (svFile[1] == "DLG_CANCEL") {
           return;
       }
       hPage = auto_LoadTemplate(GetRootDirectory() + "samples/automate/Example.ipw");
   
       auto_ImportData(svFile[1]);
       hData1 = auto_LoadDataset("Diagramm 1", "N", "EWGMOM", "BEEWG");
   
       hLayer1 = PageGetLayerHandle(hPage, "Diagramm 1");
       rmXY = [1200, 20; 1600, 50; 2200, 30; 2600, 80];
       hDataXY = auto_xy_CreateDataset(hLayer1, "Curve", rmXY[;1],rmXY[;2]);

       hLayer1 = PageGetLayerHandle(hPage, "Diagramm 2");

       hDataNew = auto_xyz_CrossSectionXY([hData1, hLayer1], hDataXY, 1)

       auto_ScaleAxes();
       auto_UpdatePage(TRUE);
   } 

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.70.6
     - Dokumentation zugefügt.

.. seealso::
   :ref:`uberblick-automatisierung-der-diagrammerstellung`,
   :ref:`auto_LoadDataset`

:sub:`id-122829`