.. highlightlang:: us

.. _xycreate:

XYCreate
========

.. index:: XYCreate

.. us.tag  XYCreate GERMAN Changed530

:ref:`XYCreate` erzeugt einen 2D-Datensatz.

.. function::  hData = XYCreate(ssName)
    hData = XYCreate(ssName, rvX, rvY)
    hData = XYCreate(ssName, rvX, rvY, hDoc)

.. us.return

**Returnwert**

*hData* ist die Zugriffsnummer (Handle) mit der auf den Datensatz zugegriffen
werden kann. Falls der Datensatz nicht erzeugt werden kann ist *hData* gleich 0.

.. us.params

**Parameter**

.. uparam:: ssName

   *ssName* ist ein skalarer String.

.. uparam:: rvX

   *rvX* ist ein Vektor mit den X-Koordinaten.

.. uparam:: rvY

   *rvY* ist ein Vektor mit den Y-Koordinaten.

.. uparam:: hDoc

   *hDoc* ist die Zugriffsnummer des Dokuments, dem der Datensatz zugeordnet
   werden soll. Ab UniPlot 5.3 wird dieser Parameter ignoriert.

.. us.comment

**Kommentar**

Die Anzahl der Elemente der Vektoren *rvX* und *rvY* muss übereinstimmen. 
Die Mindestanzahl ist 1.

Beim Aufruf ohne Daten wird ein leerer Datensatz erzeugt. 

.. us.example

**Beispiel**

::

   def test()
   {
       hDoc = DocCreate();
       hPage = PageCreate();
       DocAddPage(hDoc, hPage);
       hLayer = LayerCreate();
       PageAddLayer(hPage, hLayer);
       hData = XYCreate("Test", [1.6,2,4,6.3], [3,5,6.5,1.5]);
       LayerAddDataset(hLayer, hData);
       XYShowMarker(hData, 1)
       LayerAutoScale(hLayer);
       PageReplot(hPage);
   }
   test()

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.3.0
     - Aufruf mit einem Parameter erzeugt einen leeren Datensatz.

.. seealso::
   :ref:`uberblick-xy-datensatze`,
   :ref:`overview-data-file-informations-for-datasets`,
   :ref:`XYSetData`,
   :ref:`XYAddData`,
   :ref:`LayerCreate`,
   :ref:`TYCreate`,
   :ref:`DS_SetDataSource`

:sub:`id-769003`