.. highlightlang:: us

.. _xycopy:

XYCopy
======

.. index:: XYCopy

.. us.tag  XYCopy ENGLISH XYSet Changed427

:ref:`XYCopy` creates a copy of a 2D dataset.

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

.. us.return

**Return Value**

*hDataNew* is the handle of the new dataset. If the function fails, the return
value is FALSE (0).

.. us.params

**Parameters**

.. uparam:: hData

   The handle of a dataset created with :ref:`XYCreate` or :ref:`TYCreate`.

.. uparam:: ssNewName

   *ssNewName* is the name of the new dataset.

.. us.history

**History**

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

   * - Version
     - Description
   * - 4.2.7
     - Funtion can be invoked with only one parameter. Legend- und Info text will be copied.

.. seealso::
   :ref:`overview-xy-datasets`,
   :ref:`TYCreate`,
   :ref:`XYCreate`,
   :ref:`ObjCopy`

:sub:`id-215830`