.. highlightlang:: us

.. _auto_xy_createregion:

auto_xy_CreateRegion
====================

.. index:: auto_xy_CreateRegion

.. us.tag  auto_xy_CreateRegion NOTREADYGERMAN auto_xy

:ref:`auto_xy_CreateRegion` erzeugt aus
zwei aufsteigend sortierten Datensatzen einen Datensatz. Der zweite
Datensatz wird dazu in umgekehrter Reihenfolge an den ersten Datensatz
angehängt.

.. function::  hDataNew = auto_xy_CreateRegion(hData_Layer, hData2)

.. us.return

**Returnwert**

*hDataNew* ist die Zugriffsnummer (Handle) des neu erzeugten
Datensatzes. Falls der Datensatz nicht erzeugt werden kann, liefert
die Funktion den Wert 0.

.. us.params

**Parameter**

.. uparam:: hData_Layer

   *hData_Layer* ist entweder die Zugriffsnummer
   (Handle) des Datensatzes (*hData*) auf den die Funktion angewendet
   werden soll oder ein Vektor mit den Zugriffsnummern des Datensatzes
   und eines Diagramms ([hData, hLayer]). Wird nur ein Datensatzhandle *hData* übergeben, wird der erzeugte Datensatz dem Diagramm zugefügt,
   in dem sich *hData* befindet. Beim Aufruf mit [*hData*, *hLayer*] wird der neue Datensatz dem Diagramm *hLayer* zugefügt.

.. uparam:: hData2

   *hData2* ist die Zugriffsnummer des zweiten
   Datensatzes, der in umgekehrter Reihenfolge an den ersten Datensatz
   angehängt wird.

.. us.comment

**Kommentar**

Beide Datensätze müssen aufsteigende x-Koordinaten haben. Die
eingeschlossene Fläche kann nur schraffiert werden, wenn die Anzahl
der Datenpunkte des neuen Datensatzes kleiner als 1025 ist.

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

:sub:`id-1360028`