.. highlightlang:: us

.. _xycopy:

XYCopy
======

.. index:: XYCopy

.. us.tag  XYCopy GERMAN XYSet Changed427

:ref:`XYCopy` erzeugt die identische Kopie eines vorhandenen 2D Datensatzes.

.. function::  hDataNew = XYCopy(hData)
    hDataNew = XYCopy(hData, ssNewName)

.. us.return

**Returnwert**

*hDataNew* ist die Zugriffsnummer des neu erzeugten Datensatzes, wenn die
Funktion erfolgreich war und 0, wenn die Funktion nicht erfolgreich war.

.. us.params

**Parameter**

.. uparam:: hData

   *hData* ist die Zugriffsnummer (Handle) des Datensatzes der mit :ref:`XYCreate`
   oder :ref:`TYCreate` erzeugt wurde.

.. uparam:: ssNewName

   *ssNewName* ist der Name des neu zu erzeugenden Datensatzes.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 4.2.7
     - Kann ohne zweiten Parameter aufgerufen werden. Kopiert auch den Legenden- und Infotext mit.

.. seealso::
   :ref:`uberblick-xy-datensatze`,
   :ref:`TYCreate`,
   :ref:`XYCreate`,
   :ref:`ObjCopy`

:sub:`id-215830`